# subscription.created

HTML: https://www.app2email.com/docs/api/webhooks/subscription.created · Index: https://www.app2email.com/docs/api/llms.txt

A client number got a plan (Stripe checkout, a free or a given plan).

Group: Partner. Header `X-App2email-Event: subscription.created`. 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.subscription` | object | yes |  |
| `data.subscription.id` | integer |  |  |
| `data.subscription.client_id` | string |  |  |
| `data.subscription.number` | string |  |  |
| `data.subscription.tier_id` | string |  |  |
| `data.subscription.tier_name` | string |  |  |
| `data.subscription.interval` | string |  | one of: `month`, `year`, `none` |
| `data.subscription.messages_per_month` | integer |  |  |
| `data.subscription.price` | object |  |  |
| `data.subscription.price.amount_minor` | integer |  |  |
| `data.subscription.price.currency` | string |  |  |
| `data.subscription.status` | string |  | Stripe's status: active, trialing, past_due, canceled ... |
| `data.subscription.source` | string |  | one of: `stripe`, `free`, `comp` |
| `data.subscription.cancel_at_period_end` | boolean |  |  |
| `data.subscription.current_period_start` | string |  |  |
| `data.subscription.current_period_end` | string |  |  |
| `data.subscription.is_current` | boolean |  |  |
| `data.subscription.canceled_at` | string |  |  |
| `data.subscription.ended_reason` | string |  |  |
| `data.subscription.test_mode` | boolean |  | Bought through Stripe's test mode (the test site). |
| `data.timestamp` | string |  |  |

## Samples

### stripe

```json
{
  "id": "evt_Pt08k9m2Lw8Rt5Yp1Zs0",
  "type": "subscription.created",
  "created": "2026-11-06T09:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "subscription": {
      "id": 4211,
      "tier_id": "growth",
      "tier_name": "Growth",
      "interval": "month",
      "messages_per_month": 2000,
      "price": {
        "amount_minor": 4900,
        "currency": "usd"
      },
      "status": "active",
      "source": "stripe",
      "cancel_at_period_end": false,
      "current_period_start": "2026-11-01T00:00:00Z",
      "current_period_end": "2026-12-01T00:00:00Z",
      "is_current": true,
      "canceled_at": null,
      "ended_reason": null,
      "test_mode": false,
      "client_id": "k3x9q2m7v8w1r4t",
      "number": "4976659348270"
    },
    "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`
