API, Webhooks & MCP
Public REST API, signed webhooks and the MCP server for Claude, ChatGPT and other AI assistants.
11 guidesREST API
- Vatli REST API — overview and authentication Base URL, API keys, scopes, the response envelope, error codes, rate limits and pagination.
- Create and manage API keys Create a key with the right scopes, store it safely, see when it was last used and revoke it.
- “API: send a WhatsApp message” POST /api/v1/messages — send text, media or a template to a phone number. The contact and conversation are created for you.
- “API: contacts” List, search, create (find-or-create by phone), read and update contacts and their tags.
- “API: conversations and messages” List conversations by status or contact, read one, and page through its messages with delivery status.
- “API: launch a broadcast” POST /api/v1/broadcasts sends one approved template to up to 1,000 numbers per call, with per-recipient variables.
- API campaigns Save a template once and send it from your website, Zapier or Pabbly with one call — Vatli adds the contact, tags them and fills the blanks.
Webhooks
- Set up webhooks Get a signed JSON event at your URL whenever something happens in Vatli — for your CRM, n8n, Make or Zapier.
- Webhook events and payloads All 21 events — messages, contacts, flows, broadcasts, templates and Click-to-WhatsApp leads — with the envelope and example payloads.
- Verify webhook signatures (Node.js, Python, PHP) Check the X-Vatli-Signature header with your endpoint's secret before trusting a request — copy-paste code included.