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

SetupIntent canceled

Identified by type field in the body Resource setup_intent

stripe-setup-intent-canceled.json
{
  "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

Send example to Inspect → View as JSON

setup_intent.created

verified from a captured delivery

New SetupIntent created

Identified by type field in the body Resource setup_intent

stripe-setup-intent-created.json
{
  "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

Send example to Inspect → View as JSON

setup_intent.requires_action

documented official schema

SetupIntent needs customer action

Identified by type field in the body Resource setup_intent

stripe-setup-intent-requires-action.json
{
  "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

Send example to Inspect → View as JSON

setup_intent.setup_failed

documented official schema

SetupIntent fails to set up a payment method

Identified by type field in the body Resource setup_intent

stripe-setup-intent-setup-failed.json
{
  "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

Send example to Inspect → View as JSON

setup_intent.succeeded

verified from a captured delivery

SetupIntent sets up a payment method

Identified by type field in the body Resource setup_intent

stripe-setup-intent-succeeded.json
{
  "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

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.