Stripe reserve webhook events
Stripe sends 7 reserve events, including reserve.hold.created, reserve.hold.updated and reserve.plan.created.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
reserve.hold.created
documented official schema
reserve.hold.created Reserve hold created
Identified by type field in the body
Resource reserve
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1413853096,
"created": 1028554472,
"created_by": "application",
"currency": "usd",
"id": "obj_123",
"livemode": true,
"object": "reserve.hold",
"reason": "charge",
"release_schedule": { … },
"reserve_plan": null,
"source_charge": null
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "reserve.hold.created"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | obj_123 |
data.object.amount | integer | 1413853096 |
data.object.created | integer | 1028554472 |
Full schema: 27 fields.
From Stripe docs
-
Content type
application/json
reserve.hold.updated
documented official schema
reserve.hold.updated Reserve hold changes
Identified by type field in the body
Resource reserve
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1413853096,
"created": 1028554472,
"created_by": "application",
"currency": "usd",
"id": "obj_123",
"livemode": true,
"object": "reserve.hold",
"reason": "charge",
"release_schedule": { … },
"reserve_plan": null,
"source_charge": null
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "reserve.hold.updated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | obj_123 |
data.object.amount | integer | 1413853096 |
data.object.created | integer | 1028554472 |
Full schema: 27 fields.
From Stripe docs
-
Content type
application/json
reserve.plan.created
documented official schema
reserve.plan.created Reserve plan created
Identified by type field in the body
Resource reserve
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"created": 1028554472,
"created_by": "application",
"currency": null,
"disabled_at": null,
"id": "obj_123",
"livemode": true,
"object": "reserve.plan",
"percent": 678927291,
"status": "active",
"type": "fixed_release",
"destination": "risk_reserved"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "reserve.plan.created"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | obj_123 |
data.object.status | string | active |
data.object.type | string | fixed_release |
data.object.created | integer | 1028554472 |
Full schema: 23 fields.
From Stripe docs
-
Content type
application/json
reserve.plan.disabled
documented official schema
reserve.plan.disabled Reserve plan disabled
Identified by type field in the body
Resource reserve
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"created": 1028554472,
"created_by": "application",
"currency": null,
"disabled_at": null,
"id": "obj_123",
"livemode": true,
"object": "reserve.plan",
"percent": 678927291,
"status": "active",
"type": "fixed_release",
"destination": "risk_reserved"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "reserve.plan.disabled"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | obj_123 |
data.object.status | string | active |
data.object.type | string | fixed_release |
data.object.created | integer | 1028554472 |
Full schema: 23 fields.
From Stripe docs
-
Content type
application/json
reserve.plan.expired
documented official schema
reserve.plan.expired Reserve plan expires
Identified by type field in the body
Resource reserve
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"created": 1028554472,
"created_by": "application",
"currency": null,
"disabled_at": null,
"id": "obj_123",
"livemode": true,
"object": "reserve.plan",
"percent": 678927291,
"status": "active",
"type": "fixed_release",
"destination": "risk_reserved"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "reserve.plan.expired"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | obj_123 |
data.object.status | string | active |
data.object.type | string | fixed_release |
data.object.created | integer | 1028554472 |
Full schema: 23 fields.
From Stripe docs
-
Content type
application/json
reserve.plan.updated
documented official schema
reserve.plan.updated Reserve plan changes
Identified by type field in the body
Resource reserve
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"created": 1028554472,
"created_by": "application",
"currency": null,
"disabled_at": null,
"id": "obj_123",
"livemode": true,
"object": "reserve.plan",
"percent": 678927291,
"status": "active",
"type": "fixed_release",
"destination": "risk_reserved"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "reserve.plan.updated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | obj_123 |
data.object.status | string | active |
data.object.type | string | fixed_release |
data.object.created | integer | 1028554472 |
Full schema: 23 fields.
From Stripe docs
-
Content type
application/json
reserve.release.created
documented official schema
reserve.release.created Reserve release created
Identified by type field in the body
Resource reserve
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1413853096,
"created": 1028554472,
"created_by": "application",
"currency": "usd",
"id": "obj_123",
"livemode": true,
"object": "reserve.release",
"reason": "hold_expired",
"released_at": 213824117,
"reserve_hold": null,
"reserve_plan": null
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "reserve.release.created"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | obj_123 |
data.object.amount | integer | 1413853096 |
data.object.created | integer | 1028554472 |
Full schema: 24 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.