Docs
Engage API
A clean REST API for the WhatsApp Business Platform. Send any message type, manage templates, contacts and campaigns, and receive signed webhooks — with predictable errors, idempotency and cursor pagination.
Send your first WhatsApp message in under five minutes.
Create scoped API keys and call the API securely.
Text, media, templates, interactive and more.
Receive signed events for messages, statuses and campaigns.
Base URL
All endpoints live under a single versioned base URL. Every request and response body is JSON, with snake_case fields, UUID ids and RFC 3339 UTC timestamps.
https://api.engage.swastik.ai/v1https://api.engage.swastik.ai/v1. If your workspace runs on a dedicated or self-hosted domain, substitute your own API host — paths are identical.How it fits together
- Numbers — WhatsApp phone numbers connected to your organization through Embedded Signup in the dashboard.
- Messages — send with
POST /v1/messages; delivery updates arrive asmessage.statuswebhooks. - Templates — pre-approved message formats required to start conversations outside the 24-hour customer service window.
- Contacts — people you message, with tags, custom attributes and an opt-in state.
- Campaigns — template broadcasts to an audience, with scheduling and live stats.
The 24-hour window
When a customer messages you, a customer service window opens for 24 hours. Inside it you can send any message type. Outside it, WhatsApp only allows approved templates. Engage returns validation_failed if you try to send a free-form message to a closed window.