Errors

Understand common API errors

All public API errors return a simple machine-readable code plus a human-readable message so your developers can handle retries and user feedback cleanly.

unauthorized
API key is missing, invalid, or expired.
forbidden
The API key does not have permission for this endpoint.
invalid_request
The JSON body is malformed or required fields are missing.
invalid_phone
The phone number is not valid or is not on WhatsApp.
sender_not_configured
The account has no valid WhatsApp sender configured.
template_not_found
The requested template could not be found on the account.
template_rejected
The template is not approved or is tied to a removed sender.
template_sender_mismatch
The template does not belong to the selected sender number.
outside_customer_service_window
Free-form text was attempted outside the 24-hour window.
meta_send_failed
Meta rejected the send request for another reason.

Code	Meaning
`unauthorized`	API key is missing, invalid, or expired.
`forbidden`	The API key does not have permission for this endpoint.
`invalid_request`	The JSON body is malformed or required fields are missing.
`invalid_phone`	The phone number is not valid or is not on WhatsApp.
`sender_not_configured`	The account has no valid WhatsApp sender configured.
`template_not_found`	The requested template could not be found on the account.
`template_rejected`	The template is not approved or is tied to a removed sender.
`template_sender_mismatch`	The template does not belong to the selected sender number.
`outside_customer_service_window`	Free-form text was attempted outside the 24-hour window.
`meta_send_failed`	Meta rejected the send request for another reason.