WAgate API
Send and receive WhatsApp messages from your own code, with one channel per number. Every request goes to the address below with your channel token.
Start here
Quickstart
Link a number, send your first message and receive your first webhook.API reference
Every route, field and error code, generated from the OpenAPI spec.Agent skill
A skill file that teaches an AI agent to use a channel without costly mistakes.MCP server
Read chats and, when you allow it, send through a channel from any MCP client.llms.txt
The docs as plain text, for AI agents to read in one request.
https://api-wagate.socialground.co/v1Guides
Quickstart
Send your first message and receive your first webhook.Authentication and conventions
Your channel token, what it opens, and the conventions every route shares.Sending messages
Send text, polls and contact cards, reply, mention, react, delete, mark read, show presence.Media
Send images, video, audio, voice notes and documents from a URL, and download media you received.Webhooks
Receive events, verify them, and handle retries and duplicates.Webhook events
The four event types WAgate sends, with the payload of each.Limits
What limits a channel has, and what each 429 means.Errors
Every error code the API returns, what causes it, and what to do.Groups
List, create and manage groups: participants, subject, description, settings, invite link.Communities
Create a community, add subgroups, link groups, list participants, get the invite link.Contacts
Check which numbers are on WhatsApp, and save, read and remove contacts.Chats and history
List chats, read a conversation page by page, and ask the phone for older history.Your channel and its health
Read and rename your channel, read its health, and pace sending.Recipes
Retry safely, handle sends of unknown outcome, mark reads, and pace volume.Warming
Switch warming on or off for a channel, and read its progress.
Stuck? Email [email protected]. A person reads it and answers.
For AI agents: /llms.txt · /llms-full.txt · /docs/openapi.json