Stripe identity webhook events

Stripe sends 6 identity events, including identity.verification_session.canceled, identity.verification_session.created and identity.verification_session.processing.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

identity.verification_session.canceled

documented official schema

Identity verification session canceled

Identified by type field in the body Resource identity

stripe-identity-verification-session-canceled.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "client_reference_id": null,
      "client_secret": null,
      "created": 1234567890,
      "id": "vs_1Pgc76B7WZ01zgkWBdQi8PTU",
      "last_error": { … },
      "last_verification_report": "vr_QXhW13B2hsHOm43JtUgs0f0w",
      "livemode": false,
      "metadata": { … },
      "object": "identity.verification_session",
      "options": { … },
      "status": "verified",
      "type": "document"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "identity.verification_session.canceled"
}

Key fields

Field Type Example
data.object.id string vs_1Pgc76B7WZ01zgkWBdQi8PTU
data.object.status string verified
data.object.type string document
data.object.created integer 1234567890

Full schema: 33 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

identity.verification_session.created

documented official schema

Identity verification session created

Identified by type field in the body Resource identity

stripe-identity-verification-session-created.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "client_reference_id": null,
      "client_secret": null,
      "created": 1234567890,
      "id": "vs_1Pgc76B7WZ01zgkWBdQi8PTU",
      "last_error": { … },
      "last_verification_report": "vr_QXhW13B2hsHOm43JtUgs0f0w",
      "livemode": false,
      "metadata": { … },
      "object": "identity.verification_session",
      "options": { … },
      "status": "verified",
      "type": "document"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "identity.verification_session.created"
}

Key fields

Field Type Example
data.object.id string vs_1Pgc76B7WZ01zgkWBdQi8PTU
data.object.status string verified
data.object.type string document
data.object.created integer 1234567890

Full schema: 33 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

identity.verification_session.processing

documented official schema

Identity verification session starts processing

Identified by type field in the body Resource identity

stripe-identity-verification-session-processing.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "client_reference_id": null,
      "client_secret": null,
      "created": 1234567890,
      "id": "vs_1Pgc76B7WZ01zgkWBdQi8PTU",
      "last_error": { … },
      "last_verification_report": "vr_QXhW13B2hsHOm43JtUgs0f0w",
      "livemode": false,
      "metadata": { … },
      "object": "identity.verification_session",
      "options": { … },
      "status": "verified",
      "type": "document"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "identity.verification_session.processing"
}

Key fields

Field Type Example
data.object.id string vs_1Pgc76B7WZ01zgkWBdQi8PTU
data.object.status string verified
data.object.type string document
data.object.created integer 1234567890

Full schema: 33 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

identity.verification_session.redacted

documented official schema

Identity verification session redacted

Identified by type field in the body Resource identity

stripe-identity-verification-session-redacted.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "client_reference_id": null,
      "client_secret": null,
      "created": 1234567890,
      "id": "vs_1Pgc76B7WZ01zgkWBdQi8PTU",
      "last_error": { … },
      "last_verification_report": "vr_QXhW13B2hsHOm43JtUgs0f0w",
      "livemode": false,
      "metadata": { … },
      "object": "identity.verification_session",
      "options": { … },
      "status": "verified",
      "type": "document"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "identity.verification_session.redacted"
}

Key fields

Field Type Example
data.object.id string vs_1Pgc76B7WZ01zgkWBdQi8PTU
data.object.status string verified
data.object.type string document
data.object.created integer 1234567890

Full schema: 33 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

identity.verification_session.requires_input

documented official schema

Identity verification session needs input from the user

Identified by type field in the body Resource identity

stripe-identity-verification-session-requires-input.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "client_reference_id": null,
      "client_secret": null,
      "created": 1234567890,
      "id": "vs_1Pgc76B7WZ01zgkWBdQi8PTU",
      "last_error": { … },
      "last_verification_report": "vr_QXhW13B2hsHOm43JtUgs0f0w",
      "livemode": false,
      "metadata": { … },
      "object": "identity.verification_session",
      "options": { … },
      "status": "verified",
      "type": "document"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "identity.verification_session.requires_input"
}

Key fields

Field Type Example
data.object.id string vs_1Pgc76B7WZ01zgkWBdQi8PTU
data.object.status string verified
data.object.type string document
data.object.created integer 1234567890

Full schema: 33 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

identity.verification_session.verified

documented official schema

Identity verification session passes

Identified by type field in the body Resource identity

stripe-identity-verification-session-verified.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "client_reference_id": null,
      "client_secret": null,
      "created": 1234567890,
      "id": "vs_1Pgc76B7WZ01zgkWBdQi8PTU",
      "last_error": { … },
      "last_verification_report": "vr_QXhW13B2hsHOm43JtUgs0f0w",
      "livemode": false,
      "metadata": { … },
      "object": "identity.verification_session",
      "options": { … },
      "status": "verified",
      "type": "document"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "identity.verification_session.verified"
}

Key fields

Field Type Example
data.object.id string vs_1Pgc76B7WZ01zgkWBdQi8PTU
data.object.status string verified
data.object.type string document
data.object.created integer 1234567890

Full schema: 33 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.