# Stripe subscription webhook events

Stripe sends 8 subscription events. `customer.subscription.updated` covers plan and quantity changes, and `customer.subscription.deleted` means the subscription has ended. Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/stripe/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill stripe-webhooks` ([details](https://hookdeck.com/webhooks/stripe/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Stripe's official docs](https://docs.stripe.com/event-destinations).

[Overview](https://hookdeck.com/webhooks/stripe) · [Webhook events (246)](https://hookdeck.com/webhooks/stripe/events) · [MCP events](https://hookdeck.com/webhooks/stripe/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/stripe/verify) · [Production guide](https://hookdeck.com/webhooks/stripe/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/stripe/skill)

## customer.subscription.created

Confidence: verified · Schema: from a captured delivery

New subscription starts

Identified by: type field in the body · Object: `subscription`

```json
{
  "id": "evt_1MhUZtE0b6fckueSDaOf1oJ8",
  "object": "event",
  "api_version": "2022-11-15",
  "created": 1677834420,
  "data": {
    "object": {
      "id": "sub_1MhUZrE0b6fckueSZfQ2Ytz6",
      "object": "subscription",
      "application": null,
      "application_fee_percent": null,
      "automatic_tax": { … },
      "billing_cycle_anchor": 1680426419,
      "billing_thresholds": null,
      "cancel_at": null,
      "cancel_at_period_end": false,
      "created": 1677834419,
      "customer": "cus_NSPOMxl5eL01qM",
      "status": "trialing"
    }
  },
  "livemode": false,
  "pending_webhooks": 4,
  "request": { … },
  "type": "customer.subscription.created"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-created.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `sub_1MhUZrE0b6fckueSZfQ2Ytz6` |
| `data.object.status` | string | `trialing` |
| `data.object.customer` | string | `cus_NSPOMxl5eL01qM` |
| `data.object.created` | integer | `1677834419` |

Seen in a captured delivery: content type `application/json; charset=utf-8` · API version `2022-11-15` · headers `user-agent`, `content-type`, `stripe-signature`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-created.json)

## customer.subscription.updated

Confidence: documented · Schema: official schema

Subscription changes (plan, quantity)

Identified by: type field in the body · Object: `subscription`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "application": null,
      "application_fee_percent": null,
      "automatic_tax": { … },
      "billing_cycle_anchor": 1234567890,
      "billing_cycle_anchor_config": { … },
      "cancel_at": 1234567890,
      "canceled_at": 1234567890,
      "cancellation_details": { … },
      "collection_method": "charge_automatically",
      "customer": "cus_QXg1o8vcGmoR32",
      "id": "sub_1Pgc6rB7WZ01zgkWNy0Cn5nw",
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.subscription.updated"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-updated.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `sub_1Pgc6rB7WZ01zgkWNy0Cn5nw` |
| `data.object.status` | string | `active` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |
| `data.object.cancel_at` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-updated.json)

## customer.subscription.deleted

Confidence: documented · Schema: official schema

Subscription canceled or expired

Identified by: type field in the body · Object: `subscription`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "application": null,
      "application_fee_percent": null,
      "automatic_tax": { … },
      "billing_cycle_anchor": 1234567890,
      "billing_cycle_anchor_config": { … },
      "cancel_at": 1234567890,
      "canceled_at": 1234567890,
      "cancellation_details": { … },
      "collection_method": "charge_automatically",
      "customer": "cus_QXg1o8vcGmoR32",
      "id": "sub_1Pgc6rB7WZ01zgkWNy0Cn5nw",
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.subscription.deleted"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-deleted.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `sub_1Pgc6rB7WZ01zgkWNy0Cn5nw` |
| `data.object.status` | string | `active` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |
| `data.object.cancel_at` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-deleted.json)

## customer.subscription.paused

Confidence: documented · Schema: official schema

Subscription enters the paused status

Identified by: type field in the body · Object: `subscription`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "application": null,
      "application_fee_percent": null,
      "automatic_tax": { … },
      "billing_cycle_anchor": 1234567890,
      "billing_cycle_anchor_config": { … },
      "cancel_at": 1234567890,
      "canceled_at": 1234567890,
      "cancellation_details": { … },
      "collection_method": "charge_automatically",
      "customer": "cus_QXg1o8vcGmoR32",
      "id": "sub_1Pgc6rB7WZ01zgkWNy0Cn5nw",
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.subscription.paused"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-paused.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `sub_1Pgc6rB7WZ01zgkWNy0Cn5nw` |
| `data.object.status` | string | `active` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |
| `data.object.cancel_at` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-paused.json)

## customer.subscription.pending_update_applied

Confidence: documented · Schema: official schema

Subscription's pending update takes effect

Identified by: type field in the body · Object: `subscription`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "application": null,
      "application_fee_percent": null,
      "automatic_tax": { … },
      "billing_cycle_anchor": 1234567890,
      "billing_cycle_anchor_config": { … },
      "cancel_at": 1234567890,
      "canceled_at": 1234567890,
      "cancellation_details": { … },
      "collection_method": "charge_automatically",
      "customer": "cus_QXg1o8vcGmoR32",
      "id": "sub_1Pgc6rB7WZ01zgkWNy0Cn5nw",
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.subscription.pending_update_applied"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-pending-update-applied.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `sub_1Pgc6rB7WZ01zgkWNy0Cn5nw` |
| `data.object.status` | string | `active` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |
| `data.object.cancel_at` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-pending-update-applied.json)

## customer.subscription.pending_update_expired

Confidence: documented · Schema: official schema

Subscription's pending update expires before its invoice is paid

Identified by: type field in the body · Object: `subscription`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "application": null,
      "application_fee_percent": null,
      "automatic_tax": { … },
      "billing_cycle_anchor": 1234567890,
      "billing_cycle_anchor_config": { … },
      "cancel_at": 1234567890,
      "canceled_at": 1234567890,
      "cancellation_details": { … },
      "collection_method": "charge_automatically",
      "customer": "cus_QXg1o8vcGmoR32",
      "id": "sub_1Pgc6rB7WZ01zgkWNy0Cn5nw",
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.subscription.pending_update_expired"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-pending-update-expired.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `sub_1Pgc6rB7WZ01zgkWNy0Cn5nw` |
| `data.object.status` | string | `active` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |
| `data.object.cancel_at` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-pending-update-expired.json)

## customer.subscription.resumed

Confidence: documented · Schema: official schema

Paused subscription resumes

Identified by: type field in the body · Object: `subscription`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "application": null,
      "application_fee_percent": null,
      "automatic_tax": { … },
      "billing_cycle_anchor": 1234567890,
      "billing_cycle_anchor_config": { … },
      "cancel_at": 1234567890,
      "canceled_at": 1234567890,
      "cancellation_details": { … },
      "collection_method": "charge_automatically",
      "customer": "cus_QXg1o8vcGmoR32",
      "id": "sub_1Pgc6rB7WZ01zgkWNy0Cn5nw",
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.subscription.resumed"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-resumed.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `sub_1Pgc6rB7WZ01zgkWNy0Cn5nw` |
| `data.object.status` | string | `active` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |
| `data.object.cancel_at` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-resumed.json)

## customer.subscription.trial_will_end

Confidence: documented · Schema: official schema

Trial ends in three days, or a trial is ended early

Identified by: type field in the body · Object: `subscription`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "application": null,
      "application_fee_percent": null,
      "automatic_tax": { … },
      "billing_cycle_anchor": 1234567890,
      "billing_cycle_anchor_config": { … },
      "cancel_at": 1234567890,
      "canceled_at": 1234567890,
      "cancellation_details": { … },
      "collection_method": "charge_automatically",
      "customer": "cus_QXg1o8vcGmoR32",
      "id": "sub_1Pgc6rB7WZ01zgkWNy0Cn5nw",
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.subscription.trial_will_end"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-trial-will-end.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `sub_1Pgc6rB7WZ01zgkWNy0Cn5nw` |
| `data.object.status` | string | `active` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |
| `data.object.cancel_at` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-subscription-trial-will-end.json)

---

Not affiliated with Stripe. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/stripe.json) · [Report a correction](https://hookdeck.com/contact)
