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.
Try it
With an API key in ENGAGE_API_KEY, this sends WhatsApp's built-in hello_world template to your own phone:
curl https://engage.swastik.ai/v1/messages \
-H "Authorization: Bearer $ENGAGE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to":"14155550101","type":"template","template":{"name":"hello_world","language":"en_US"}}'Press / anywhere in the docs to search endpoints, fields and error codes.
Base URL
All endpoints live under a single versioned base URL. Request and response bodies are JSON with snake_case fields, UUID ids and RFC 3339 UTC timestamps. The exceptions are file uploads (multipart/form-data), media downloads (raw bytes) and the contact export (CSV).
https://engage.swastik.ai/v1https://engage.swastik.ai. API requests go to https://engage.swastik.ai/v1 with an Authorization: Bearer egk_live_… key from Developers → API keys. HTTPS only.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. - Conversations — one thread per contact and number, with the shared team inbox on top.
- Templates — pre-approved message formats required to start conversations outside the 24-hour customer service window.
- Contacts — people you message, with tags, lists, segments, 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. Each conversation carries csw_expires_at so you can see when its window closes.
Conventions
Frequently asked questions
What is Engage?
Engage by Swastik is software for businesses that use WhatsApp: template campaigns, a shared team inbox, automations and a developer API. It is built by Shwastik Tech Solutions Pvt Ltd and runs at engage.swastik.ai.
Does Engage use the official WhatsApp Business Platform (Cloud API)?
Yes. Numbers are connected through Meta's Embedded Signup and every message is sent through Meta's official WhatsApp Business Platform Cloud API — no unofficial clients or scraping.
How do I send a WhatsApp message with the Engage API?
Create an API key with the messages:send permission, then POST a JSON body with to, type and the message content to https://engage.swastik.ai/v1/messages using an Authorization: Bearer header. The API answers 202 with the message id, and delivery updates arrive as message.status webhooks. See Quick start.
How much does it cost, and who bills WhatsApp message fees?
There is no subscription. You top up a prepaid wallet and every delivered message has one all-inclusive price by category (marketing, utility, authentication, service). New accounts start with free credit, and every feature is included. See Pricing.
Is there a sandbox or test mode?
No. Keys can be labelled live (egk_live_) or test (egk_test_), but both send real WhatsApp messages through your connected numbers. Test against your own phone number. See Authentication.
What are the API rate limits?
Each API key gets a steady 100 requests per second by default (higher limits on request), with short bursts up to twice that. Over the limit the API returns 429 with a Retry-After header. See Errors & rate limits.
How do I receive incoming WhatsApp messages?
Add an HTTPS webhook endpoint in Developers → Webhooks and subscribe to message.received. Engage POSTs each inbound message to your URL, signed with HMAC-SHA256 in the Engage-Signature header. See Webhooks.
Can I use Engage from ChatGPT or Claude?
Yes. Engage runs an MCP server, so ChatGPT, Claude and other MCP clients can send messages, look up contacts and check campaigns for you. What the assistant can do is limited by the permissions you grant it. See MCP server.