# 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](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)

## setup_intent.canceled

Confidence: documented · Schema: official schema

SetupIntent canceled

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

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/setup-intent-canceled.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `seti_1Pgag7B7WZ01zgkWSgwGdb8Z` |
| `data.object.status` | string | `requires_payment_method` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/setup-intent-canceled.json)

## setup_intent.created

Confidence: verified · Schema: from a captured delivery

New SetupIntent created

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

```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"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `seti_1MhUZpE0b6fckueSO1ROP6RG` |
| `data.object.status` | string | `succeeded` |
| `data.object.created` | integer | `1677834417` |

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/setup-intent-created.json)

## setup_intent.requires_action

Confidence: documented · Schema: official schema

SetupIntent needs customer action

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

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/setup-intent-requires-action.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `seti_1Pgag7B7WZ01zgkWSgwGdb8Z` |
| `data.object.status` | string | `requires_payment_method` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/setup-intent-requires-action.json)

## setup_intent.setup_failed

Confidence: documented · Schema: official schema

SetupIntent fails to set up a payment method

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

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/setup-intent-setup-failed.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `seti_1Pgag7B7WZ01zgkWSgwGdb8Z` |
| `data.object.status` | string | `requires_payment_method` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/setup-intent-setup-failed.json)

## setup_intent.succeeded

Confidence: verified · Schema: from a captured delivery

SetupIntent sets up a payment method

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

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/setup-intent-succeeded.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `seti_1MhUZpE0b6fckueSO1ROP6RG` |
| `data.object.status` | string | `succeeded` |
| `data.object.created` | integer | `1677834417` |

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/setup-intent-succeeded.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)
