# number.error

HTML: https://www.app2email.com/docs/api/webhooks/number.error · Index: https://www.app2email.com/docs/api/llms.txt

WhatsApp reported an error that is not about one message, eg too many messages in a short time.

Group: Number. Header `X-App2email-Event: number.error`. Inside the envelope `{id, type, created, number, test?, data}` ([envelope, headers, signature](https://www.app2email.com/docs/api/webhooks.md)). Every webhook of the number gets every number event: filter by `type`.

## data

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data.code` | integer | yes | Meta's error code, eg 130429. |
| `data.title` | string |  |  |
| `data.message` | string |  |  |
| `data.details` | string |  |  |
| `data.href` | string |  |  |
| `data.error_code` | string |  | app2email's code for it (/docs/api/errors). |
| `data.how_to_fix` | string |  |  |
| `data.is_retriable` | boolean |  |  |
| `data.retry_after_seconds` | integer |  |  |
| `data.timestamp` | string |  |  |

## Samples

### rate limit

```json
{
  "id": "evt_Pa3k9m2Lw8Rt5Yp1Zs09",
  "type": "number.error",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "code": 130429,
    "title": "Rate limit hit",
    "message": "Rate limit hit",
    "details": "Message failed to send because there were too many messages sent from this phone number in a short period of time.",
    "href": "https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes",
    "error_code": "whatsapp_rate_limit",
    "how_to_fix": "WhatsApp's rate limit was reached. Slow down and try again in a minute.",
    "is_retriable": true,
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

Send it to your URL: https://www.app2email.com/docs/api/webhooks/tester?type=number.error
