WhatsApp API
Send Meta-approved template messages from your own WhatsApp Business Account — the official Business Platform, not a grey-route bot.
Auth: mbs_ scoped tokens
WhatsApp lives under
/api/v1/ and requires an mbs_ token with WhatsApp scopes — see Authentication. Responses use the { success, data, error } envelope.How it fits together
- Connect an account — your WABA credentials (phone number ID, WABA ID, access token) connect once; templates sync automatically.
- Templates — created and reviewed with Meta; their live review status is mirrored here. Only approved templates can send.
- Send — pick a template, supply recipients and variable values; delivery and read receipts stream back.
Connect a WhatsApp Business Account
POSThttps://api.mobilesasa.com/api/v1/whatsapp/accounts
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | A label for this account (shown in listings). |
| phone_number_id | string | Yes | Meta phone number ID from the WhatsApp Business Platform. |
| waba_id | string | Yes | Your WhatsApp Business Account ID. |
| api_key | string | Yes | A permanent Meta access token for the WABA. |
| msisdn | string | No | The display number, for your own reference. |
| app_id | string | No | Meta app ID, if you scope tokens per app. |
curl -X POST https://api.mobilesasa.com/api/v1/whatsapp/accounts \
-H "Authorization: Bearer $MOBILESASA_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Main line",
"phone_number_id": "1093857629",
"waba_id": "204817593",
"api_key": "EAAG…"
}'Connecting triggers an immediate template sync from Meta. List your accounts with GET /api/v1/whatsapp/accounts; disconnect with DELETE /api/v1/whatsapp/accounts/{uuid}.