# WAgate

> Put a WhatsApp number behind an API from $25 a month, flat. Send and receive, run groups and communities, and get a signed webhook with a stable delivery id for everything that happens on the number. Free sandbox, forever, no card.

API: https://api-wagate.socialground.co/v1
Pricing: 1 to 4 channels: $25 per channel per month, or $240 per year; 5 to 9 channels: $20 per channel per month, or $192 per year; 10 or more channels: $11 per channel per month, or $106 per year. Yearly saves about 20%.
Docs: public, no sign-in needed. Start at https://wagate.dev/docs.

## Docs

- [Docs](https://wagate.dev/docs)
- [Quickstart](https://wagate.dev/docs/quickstart): Send your first message and receive your first webhook.
- [Authentication and conventions](https://wagate.dev/docs/authentication): Your channel token, what it opens, and the conventions every route shares.
- [Sending messages](https://wagate.dev/docs/messages): Send text, polls and contact cards, reply, mention, react, delete, mark read, show presence.
- [Media](https://wagate.dev/docs/media): Send images, video, audio, voice notes and documents from a URL, and download media you received.
- [Webhooks](https://wagate.dev/docs/webhooks): Receive events, verify them, and handle retries and duplicates.
- [Webhook events](https://wagate.dev/docs/webhook-events): The four event types WAgate sends, with the payload of each.
- [Limits](https://wagate.dev/docs/limits): What limits a channel has, and what each 429 means.
- [Errors](https://wagate.dev/docs/errors): Every error code the API returns, what causes it, and what to do.
- [Groups](https://wagate.dev/docs/groups): List, create and manage groups: participants, subject, description, settings, invite link.
- [Communities](https://wagate.dev/docs/communities): Create a community, add subgroups, link groups, list participants, get the invite link.
- [Contacts](https://wagate.dev/docs/contacts): Check which numbers are on WhatsApp, and save, read and remove contacts.
- [Chats and history](https://wagate.dev/docs/chats): List chats, read a conversation page by page, and ask the phone for older history.
- [Your channel and its health](https://wagate.dev/docs/numbers-and-safety): Read and rename your channel, read its health, and pace sending.
- [Recipes](https://wagate.dev/docs/recipes): Retry safely, handle sends of unknown outcome, mark reads, and pace volume.
- [Warming](https://wagate.dev/docs/warming): Switch warming on or off for a channel, and read its progress.
- [API reference](https://wagate.dev/docs/reference): Every route in the public API, generated from the OpenAPI document.
- [Agent skill](https://wagate.dev/docs/agent-skill): install the WAgate skill in an AI agent
- [MCP server](https://wagate.dev/docs/mcp): use WAgate from an MCP client
- [OpenAPI spec](https://wagate.dev/docs/openapi.json): the whole API as an OpenAPI 3.1 document

## Optional

- [pricing.md](https://wagate.dev/pricing.md): the price and what a channel includes
- [llms-full.txt](https://wagate.dev/llms-full.txt): every guide below in one file

Support: hello@wagate.dev