# Introduction

Source: https://postgale.com/docs

REST API, MCP server and platform guides for publishing, messaging and ads through Postgale.

Postgale publishes and manages social accounts on behalf of a workspace through one REST API and one hosted MCP server.

## Quickstart

Start by creating a workspace, connecting the accounts you own and minting an API key in **Dashboard → API keys**; then use it as a
bearer token against `/api/v1` or `/mcp`.

```bash title="GET /api/v1/accounts"
curl https://postgale.com/api/v1/accounts \
  -H 'Authorization: Bearer sk_…'
```

## Guides

  - [REST API](https://postgale.com/docs/api): Authentication, errors, every endpoint, the create-post body and webhook verification.
  - [MCP server](https://postgale.com/docs/mcp): Connect Claude, Cursor, VS Code or any MCP client; the 70 tools and their annotations.
  - [WhatsApp Business](https://postgale.com/docs/whatsapp): Embedded Signup, templates, the 24-hour window, media, numbers and webhooks.
  - [TikTok](https://postgale.com/docs/tiktok): Login Kit, creator info, privacy levels, video and photo posts, the audit.
  - [X (coming soon)](https://postgale.com/docs/x): Not available yet. The planned character budgets, media, threads, polls, replies, engagement and search.
  - [Meta Ads](https://postgale.com/docs/ads): Boosts, campaigns, ad sets, creatives, audiences, insights and the confirm rule.

## Reference

- [API reference](https://postgale.com/docs/api-reference): every REST operation with its parameters, schemas and a request playground.
- [OpenAPI 3.1 document](https://postgale.com/api/v1/openapi.json) for the whole REST surface.
- Rate limit: 60 requests per minute per key by default (HTTP 429 over the limit). Idempotency with `x-request-id` on `POST /posts`.
- Webhooks are signed with HMAC-SHA256 over `${timestamp}.${body}`; see [Webhooks](https://postgale.com/docs/api/webhooks).
