Developers
Plug WhatsApp into your own systems.
Send messages from your app, CRM or store, and get incoming messages and status updates on your server.
The full reference is inside your dashboard, under API & Webhooks.
- 01
Bearer API keys
Each key is shown once, stored securely and can be limited to chosen numbers.
- 02
Send and look up
Send text, media, templates and WhatsApp Flows, check message status, list numbers, templates and contacts.
- 03
Safe retries
Idempotency keys so a message is never sent twice, plus rate limits and clear error codes.
- 04
Signed webhooks
HMAC-SHA256 signatures for incoming messages, delivery and read status and device status, with automatic retries and a delivery log.
- 05
Docs inside the app
Built-in docs with copy-ready curl examples.
01Send a message
curl -X POST 'https://dash.macrowa.com/api/v1/whatsapp-official/messages' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: order-1001-ready' \
-d '{
"number_id": 1,
"to": "60123456789",
"type": "text",
"payload": {
"text": "Your order is ready."
}
}'From the API reference in the dashboard (official API). The Idempotency-Key header makes a retry safe.
curl 'https://dash.macrowa.com/api/v1/whatsapp-official/numbers' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Accept: application/json'{
"status": "success",
"data": [
{
"id": 1,
"display_phone_number": "+60 12-345 6789",
"verified_name": "Kedai Ahmad",
"status": "active",
"can_send": true,
"quality_rating": "GREEN",
"messaging_limit_tier": "TIER_1K",
"connection_mode": "standard"
}
]
}

Ready to grow on WhatsApp? Start with MacroWA today.
Connect a number, teach your AI agent and switch on your first flow.
7-day free trial. Monthly or yearly plans. 30-day money-back guarantee on your first payment.