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 →

customer.subscription.created

verified from a captured delivery

New subscription starts

Identified by type field in the body Resource subscription

stripe-customer-subscription-created.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"
}

Key fields

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

Full schema: 139 fields.

Seen in a captured delivery

  • Content type application/json; charset=utf-8
  • API version 2022-11-15
  • Headers user-agent , content-type , stripe-signature

Send example to Inspect → View as JSON

customer.subscription.updated

documented official schema

Subscription changes (plan, quantity)

Identified by type field in the body Resource subscription

stripe-customer-subscription-updated.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"
}

Key fields

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

Full schema: 219 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.subscription.deleted

documented official schema

Subscription canceled or expired

Identified by type field in the body Resource subscription

stripe-customer-subscription-deleted.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"
}

Key fields

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

Full schema: 219 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.subscription.paused

documented official schema

Subscription enters the paused status

Identified by type field in the body Resource subscription

stripe-customer-subscription-paused.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"
}

Key fields

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

Full schema: 219 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.subscription.pending_update_applied

documented official schema

Subscription's pending update takes effect

Identified by type field in the body Resource subscription

stripe-customer-subscription-pending-update-applied.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"
}

Key fields

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

Full schema: 219 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.subscription.pending_update_expired

documented official schema

Subscription's pending update expires before its invoice is paid

Identified by type field in the body Resource subscription

stripe-customer-subscription-pending-update-expired.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"
}

Key fields

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

Full schema: 219 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.subscription.resumed

documented official schema

Paused subscription resumes

Identified by type field in the body Resource subscription

stripe-customer-subscription-resumed.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"
}

Key fields

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

Full schema: 219 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.subscription.trial_will_end

documented official schema

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

Identified by type field in the body Resource subscription

stripe-customer-subscription-trial-will-end.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"
}

Key fields

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

Full schema: 219 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

Route Stripe events by type.

Event Gateway receives every Stripe delivery and filters and routes it by event type, so each service gets only the events it handles.

Not affiliated with Stripe. Facts are compiled from public sources and linked inline.