Send a text message
to | Recipient number with country code, digits only (+, spaces and 00 prefix are stripped). |
text | Message text, up to 4096 characters. message is accepted as an alias. |
session | Which number sends it. Optional when the key is tied to one number, or only one number exists. |
Success
{"success":true,"data":{"id":12,"status":"sent","session":"bloomzhub","to":"97455320001","wa_message_id":"3EB0..."}}
Errors
401 unauthorized | Missing, wrong or revoked key |
400 invalid_number / invalid_request | Bad number or empty text |
403 forbidden | Key not allowed to use that number |
409 session_not_connected | Number not paired / disconnected |
422 not_on_whatsapp | Recipient has no WhatsApp |
429 rate_limited | More than 120 requests/min per key |
Other endpoints
GET /api/sessions | Numbers this key can use and their status |
GET /api/messages/{id} | Status of a sent message: sent → delivered → read, or failed |
Messages to the same number are sent one by one with a short gap, to reduce the chance of WhatsApp flagging the account.