# plan.limit_reached

HTML: https://www.app2email.com/docs/api/webhooks/plan.limit_reached · Index: https://www.app2email.com/docs/api/llms.txt

A number used all messages of its plan this billing period (once per period).

Group: Partner. Header `X-App2email-Event: plan.limit_reached`. Inside the envelope `{id, type, created, number, test?, data}` ([envelope, headers, signature](https://www.app2email.com/docs/api/webhooks.md)). Account and partner webhooks only (`/v1/account/webhooks`, `/v1/partner/webhooks`): a number's webhooks never get it.

## data

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data.number` | string | yes |  |
| `data.client_id` | string |  | The reseller's client (partner webhooks). |
| `data.timestamp` | string |  |  |
| `data.plan` | string |  |  |
| `data.plan_messages` | object |  |  |
| `data.plan_messages.whatsapp_sent` | integer |  |  |
| `data.plan_messages.emails_sent` | integer |  |  |
| `data.plan_messages.total_sent` | integer |  |  |
| `data.plan_messages.limit` | integer |  |  |
| `data.billing_period` | object |  |  |
| `data.billing_period.start` | string |  |  |
| `data.billing_period.end` | string |  |  |

## Samples

### reached

```json
{
  "id": "evt_Pt14k9m2Lw8Rt5Yp1Zs0",
  "type": "plan.limit_reached",
  "created": "2026-11-06T09:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "number": "4976659348270",
    "client_id": "k3x9q2m7v8w1r4t",
    "plan": "standard_2000",
    "plan_messages": {
      "whatsapp_sent": 1990,
      "emails_sent": 10,
      "total_sent": 2000,
      "limit": 2000
    },
    "billing_period": {
      "start": "2026-11-01T00:00:00Z",
      "end": "2026-12-01T00:00:00Z"
    },
    "timestamp": "2026-11-06T09:00:00.000Z"
  }
}
```

Test it on an account or partner webhook:

- [Send a test event to a partner webhook](https://www.app2email.com/docs/api/partner/test-partner-webhook.md): `POST /v1/partner/webhooks/{id}/test`
- [Send a test event to an account webhook](https://www.app2email.com/docs/api/account-management/test-account-webhook.md): `POST /v1/account/webhooks/{id}/test`
