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.

  1. 01

    Bearer API keys

    Each key is shown once, stored securely and can be limited to chosen numbers.

  2. 02

    Send and look up

    Send text, media, templates and WhatsApp Flows, check message status, list numbers, templates and contacts.

  3. 03

    Safe retries

    Idempotency keys so a message is never sent twice, plus rate limits and clear error codes.

  4. 04

    Signed webhooks

    HMAC-SHA256 signatures for incoming messages, delivery and read status and device status, with automatic retries and a delivery log.

  5. 05

    Docs inside the app

    Built-in docs with copy-ready curl examples.

01Send a message

POST /api/v1/whatsapp-official/messages
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.

GET /api/v1/whatsapp-official/numbers
curl 'https://dash.macrowa.com/api/v1/whatsapp-official/numbers' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK
{
    "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"
        }
    ]
}
API and webhooks page in MacroWA with active API keys, webhook status and rate limitAPI and webhooks page in MacroWA with active API keys, webhook status and rate limit
Screenshot from the MacroWA dashboard

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.