Errors

Error responses are application/problem+json. Their code is one of the codes below, and their type links to the page of that code.

Code	Status	Title
api_key_not_found	404	API key not found
channel_already_connected	409	Channel already connected
channel_disconnected	409	Channel disconnected
channel_not_found	404	Channel not found
channel_token_unreadable	409	Channel token unreadable
contact_not_found	404	Contact not found
conversation_not_found	404	Conversation not found
database_unavailable	503	Service not ready
dns_unavailable	503	DNS unavailable
erasure_unavailable	503	Erasure unavailable
http_400	400	HTTP 400: Bad request
http_401	401	HTTP 401: Unauthorized
http_402	402	HTTP 402: Payment required
http_403	403	HTTP 403: Forbidden
http_404	404	HTTP 404: Not found
http_405	405	HTTP 405: Method not allowed
http_406	406	HTTP 406: Not acceptable
http_407	407	HTTP 407: Proxy authentication required
http_408	408	HTTP 408: Request timeout
http_409	409	HTTP 409: Conflict
http_410	410	HTTP 410: Gone
http_411	411	HTTP 411: Length required
http_412	412	HTTP 412: Precondition failed
http_413	413	HTTP 413: Payload too large
http_414	414	HTTP 414: URI too long
http_415	415	HTTP 415: Unsupported media type
http_416	416	HTTP 416: Range not satisfiable
http_417	417	HTTP 417: Expectation failed
http_418	418	HTTP 418: I'm a teapot
http_421	421	HTTP 421: Misdirected request
http_422	422	HTTP 422: Unprocessable entity
http_423	423	HTTP 423: Locked
http_424	424	HTTP 424: Failed dependency
http_425	425	HTTP 425: Too early
http_426	426	HTTP 426: Upgrade required
http_428	428	HTTP 428: Precondition required
http_429	429	HTTP 429: Too many requests
http_431	431	HTTP 431: Request header fields too large
http_451	451	HTTP 451: Unavailable for legal reasons
http_500	500	HTTP 500: Internal server error
http_501	501	HTTP 501: Not implemented
http_502	502	HTTP 502: Bad gateway
http_503	503	HTTP 503: Service unavailable
http_504	504	HTTP 504: Gateway timeout
http_505	505	HTTP 505: HTTP version not supported
http_506	506	HTTP 506: Variant also negotiates
http_507	507	HTTP 507: Insufficient storage
http_508	508	HTTP 508: Loop detected
http_510	510	HTTP 510: Not extended
http_511	511	HTTP 511: Network authentication required
idempotency_in_progress	409	Request in progress
idempotency_key_required	400	Idempotency-Key required
idempotency_key_reused	422	Idempotency-Key reused
insufficient_scope	403	Insufficient scope
internal_error	500	Internal server error
invalid_api_key	401	Invalid API key
invalid_cursor	422	Invalid cursor
invalid_signature	401	Invalid signature
invalid_verification_request	400	Invalid verification request
media_expired	410	Media expired
media_not_found	404	Media not found
message_not_found	404	Message not found
meta_error	422	Meta refused the request
meta_invalid_token	422	Invalid Meta access token
meta_rate_limited	429	Meta rate limit
meta_subscription_failed	422	Could not subscribe the WABA
meta_template_rejected	422	Meta rejected the template
meta_unavailable	502	Meta unavailable
migrations_pending	503	Service not ready
missing_api_key	401	Missing API key
outside_customer_service_window	422	Outside the customer service window
payload_too_large	413	Payload too large
phone_number_not_in_waba	422	Phone number not in this WABA
revoked_api_key	401	Revoked API key
route_not_found	404	Not found
scope_escalation	403	Scope escalation
sse_capacity_reached	429	Too many event streams
sse_workspace_limit_reached	429	Too many event streams
untrusted_media_host	502	Untrusted media host
validation_failed	422	Validation failed
verify_token_mismatch	403	Verification refused
webhook_delivery_not_found	404	Webhook delivery not found
webhook_endpoint_disabled	409	Webhook endpoint disabled
webhook_endpoint_limit_reached	422	Webhook endpoint limit reached
webhook_endpoint_not_found	404	Webhook endpoint not found
webhook_url_not_allowed	422	Webhook URL not allowed
worker_not_ready	503	Worker not ready