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
customer.subscription.created New subscription starts
Identified by type field in the body
Resource subscription
{
"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
customer.subscription.updated
documented official schema
customer.subscription.updated Subscription changes (plan, quantity)
Identified by type field in the body
Resource subscription
{
"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
customer.subscription.deleted
documented official schema
customer.subscription.deleted Subscription canceled or expired
Identified by type field in the body
Resource subscription
{
"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
customer.subscription.paused
documented official schema
customer.subscription.paused Subscription enters the paused status
Identified by type field in the body
Resource subscription
{
"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
customer.subscription.pending_update_applied
documented official schema
customer.subscription.pending_update_applied Subscription's pending update takes effect
Identified by type field in the body
Resource subscription
{
"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
customer.subscription.pending_update_expired
documented official schema
customer.subscription.pending_update_expired Subscription's pending update expires before its invoice is paid
Identified by type field in the body
Resource subscription
{
"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
customer.subscription.resumed
documented official schema
customer.subscription.resumed Paused subscription resumes
Identified by type field in the body
Resource subscription
{
"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
customer.subscription.trial_will_end
documented official schema
customer.subscription.trial_will_end Trial ends in three days, or a trial is ended early
Identified by type field in the body
Resource subscription
{
"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
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.