# trial.ending

HTML: https://www.app2email.com/docs/api/webhooks/trial.ending · Index: https://www.app2email.com/docs/api/llms.txt

A number's trial ends within 3 days.

Group: Partner. Header `X-App2email-Event: trial.ending`. 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.trial_ends_at` | string | yes |  |
| `data.days_left` | integer |  |  |
| `data.plan_messages` | object |  |  |
| `data.plan_messages.total_sent` | integer |  |  |
| `data.plan_messages.limit` | integer |  |  |

## Samples

### ending

```json
{
  "id": "evt_Pt12k9m2Lw8Rt5Yp1Zs0",
  "type": "trial.ending",
  "created": "2026-11-06T09:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "number": "4976659348270",
    "client_id": "k3x9q2m7v8w1r4t",
    "trial_ends_at": "2026-11-09T09:00:00.000Z",
    "days_left": 3,
    "plan_messages": {
      "total_sent": 12,
      "limit": 50
    },
    "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`
