Errors

message_allowance_exhausted

The month's outbound messages are used up

Every plan includes a number of outbound messages per billing cycle, and this account has sent all of them. Only outbound messages count - messages arriving from other people are never counted, and neither are sends on a test key.

What to do

Nothing else stops: messages keep arriving, webhooks keep firing and the shared inbox keeps working, so anybody mid-conversation can still reach the account. To send again, wait for the cycle to reset on the account's renewal day, or move up a plan under Billing in the console, which applies immediately and to the cycle you are in. This is a 402 rather than a 429 on purpose: it will not pass on its own, so retrying with a backoff will not help.

The shape

{
  "error": {
    "type": "...",
    "code": "message_allowance_exhausted",
    "message": "...",
    "docs": "https://docs.njiwa.upeo.ai/errors/message_allowance_exhausted"
  }
}