Skip to main content

Success response

Queue message endpoints return 200 OK when the request is accepted.
{
  "queued": true
}
This response confirms the message was queued successfully. It does not confirm final delivery.

Error format

All API errors follow the Problem Details specification.

Common errors

StatusErrorDescription
401UnauthorizedNo authenticated user and no valid X-API-KEY.
400RecipientMissingThe raw payload did not include recipient.
400TemplateKeyRequiredThe raw payload did not include template.name.
400WhatsAppBusinessIdRequiredThe raw request did not include whatsappBusinessId.
400PhoneNumberIdRequiredThe raw request did not include phoneNumberId.
400WhatsAppBusinessIdDoesNotBelongToAppThe WABA does not belong to the app token.
400AppNotLinkedToWhatsAppBusinessThe app is not linked to a WhatsApp business account.
400TelegramChatNotLinkedA dev token was used but no Telegram chats are linked to the app.
400RecipientRateLimitExceededThe app’s per-recipient rate limit was exceeded.
400InsufficientBalanceThe account balance is too low to cover the message cost.