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 Identity verification session canceled
Identified by type field in the body
Resource identity
{
"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
identity.verification_session.created
documented official schema
identity.verification_session.created Identity verification session created
Identified by type field in the body
Resource identity
{
"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
identity.verification_session.processing
documented official schema
identity.verification_session.processing Identity verification session starts processing
Identified by type field in the body
Resource identity
{
"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
identity.verification_session.redacted
documented official schema
identity.verification_session.redacted Identity verification session redacted
Identified by type field in the body
Resource identity
{
"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
identity.verification_session.requires_input
documented official schema
identity.verification_session.requires_input Identity verification session needs input from the user
Identified by type field in the body
Resource identity
{
"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
identity.verification_session.verified
documented official schema
identity.verification_session.verified Identity verification session passes
Identified by type field in the body
Resource identity
{
"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
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.