FieldTypeRequiredDescription
201 CreatedSuccess-Message accepted and queued.
202 AcceptedSuccess-Message accepted for async processing.
400 Bad RequestError-Validation failure: missing required field, TTL out of range, text > 1024 chars, button title > 20 chars, > 3 buttons, header/footer > 60 chars.
401 UnauthorizedError-Invalid or expired JWT token.
403 ForbiddenError-Account restricted due to Direct Send abuse strikes. Check webhook callbacks.
422 UnprocessableError-Structurally valid JSON but semantically incorrect (unsupported media type, invalid phone format).
500 Server ErrorError-Platform error. Retry with exponential backoff.


Did this page help you?