Stripe setup_intent webhook events
Stripe sends 5 setup_intent events, including setup_intent.canceled, setup_intent.created and setup_intent.requires_action.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
setup_intent.canceled
documented official schema
setup_intent.canceled SetupIntent canceled
Identified by type field in the body
Resource setup_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"application": null,
"automatic_payment_methods": { … },
"cancellation_reason": null,
"client_secret": "seti_1Pgag7B7WZ01zgkWSgwGdb8Z_secret_QXg2AQLdBxJwtY51IkwvUaBVsnCqPSp",
"created": 1234567890,
"customer": null,
"description": null,
"flow_directions": null,
"id": "seti_1Pgag7B7WZ01zgkWSgwGdb8Z",
"last_setup_error": { … },
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "setup_intent.canceled"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | seti_1Pgag7B7WZ01zgkWSgwGdb8Z |
data.object.status | string | requires_payment_method |
data.object.created | integer | 1234567890 |
Full schema: 44 fields.
From Stripe docs
-
Content type
application/json
setup_intent.created
verified from a captured delivery
setup_intent.created New SetupIntent created
Identified by type field in the body
Resource setup_intent
{
"id": "evt_1MhUZqE0b6fckueSDMcrg1zt",
"object": "event",
"api_version": "2022-11-15",
"created": 1677834417,
"data": {
"object": {
"id": "seti_1MhUZpE0b6fckueSO1ROP6RG",
"object": "setup_intent",
"application": null,
"cancellation_reason": null,
"client_secret": "seti_1MhUZpE0b6fckueSO1ROP6RG_secret_NSPOCUAQ6cVd3xDNuz1SvYqodrJrHqh",
"created": 1677834417,
"customer": null,
"description": null,
"flow_directions": null,
"last_setup_error": null,
"status": "succeeded"
}
},
"livemode": false,
"pending_webhooks": 3,
"request": { … },
"type": "setup_intent.created"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | seti_1MhUZpE0b6fckueSO1ROP6RG |
data.object.status | string | succeeded |
data.object.created | integer | 1677834417 |
Full schema: 39 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
setup_intent.requires_action
documented official schema
setup_intent.requires_action SetupIntent needs customer action
Identified by type field in the body
Resource setup_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"application": null,
"automatic_payment_methods": { … },
"cancellation_reason": null,
"client_secret": "seti_1Pgag7B7WZ01zgkWSgwGdb8Z_secret_QXg2AQLdBxJwtY51IkwvUaBVsnCqPSp",
"created": 1234567890,
"customer": null,
"description": null,
"flow_directions": null,
"id": "seti_1Pgag7B7WZ01zgkWSgwGdb8Z",
"last_setup_error": { … },
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "setup_intent.requires_action"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | seti_1Pgag7B7WZ01zgkWSgwGdb8Z |
data.object.status | string | requires_payment_method |
data.object.created | integer | 1234567890 |
Full schema: 44 fields.
From Stripe docs
-
Content type
application/json
setup_intent.setup_failed
documented official schema
setup_intent.setup_failed SetupIntent fails to set up a payment method
Identified by type field in the body
Resource setup_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"application": null,
"automatic_payment_methods": { … },
"cancellation_reason": null,
"client_secret": "seti_1Pgag7B7WZ01zgkWSgwGdb8Z_secret_QXg2AQLdBxJwtY51IkwvUaBVsnCqPSp",
"created": 1234567890,
"customer": null,
"description": null,
"flow_directions": null,
"id": "seti_1Pgag7B7WZ01zgkWSgwGdb8Z",
"last_setup_error": { … },
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "setup_intent.setup_failed"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | seti_1Pgag7B7WZ01zgkWSgwGdb8Z |
data.object.status | string | requires_payment_method |
data.object.created | integer | 1234567890 |
Full schema: 44 fields.
From Stripe docs
-
Content type
application/json
setup_intent.succeeded
verified from a captured delivery
setup_intent.succeeded SetupIntent sets up a payment method
Identified by type field in the body
Resource setup_intent
{
"id": "evt_1MhUZqE0b6fckueSGwHOxNw6",
"object": "event",
"api_version": "2022-11-15",
"created": 1677834418,
"data": {
"object": {
"id": "seti_1MhUZpE0b6fckueSO1ROP6RG",
"object": "setup_intent",
"application": null,
"cancellation_reason": null,
"client_secret": "seti_1MhUZpE0b6fckueSO1ROP6RG_secret_NSPOCUAQ6cVd3xDNuz1SvYqodrJrHqh",
"created": 1677834417,
"customer": null,
"description": null,
"flow_directions": null,
"last_setup_error": null,
"status": "succeeded"
}
},
"livemode": false,
"pending_webhooks": 3,
"request": { … },
"type": "setup_intent.succeeded"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | seti_1MhUZpE0b6fckueSO1ROP6RG |
data.object.status | string | succeeded |
data.object.created | integer | 1677834417 |
Full schema: 39 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
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.