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

Identified by type field in the body Resource reserve

stripe-reserve-hold-created.json
{
  "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

Send example to Inspect → View as JSON

reserve.hold.updated

documented official schema

Reserve hold changes

Identified by type field in the body Resource reserve

stripe-reserve-hold-updated.json
{
  "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

Send example to Inspect → View as JSON

reserve.plan.created

documented official schema

Reserve plan created

Identified by type field in the body Resource reserve

stripe-reserve-plan-created.json
{
  "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

Send example to Inspect → View as JSON

reserve.plan.disabled

documented official schema

Reserve plan disabled

Identified by type field in the body Resource reserve

stripe-reserve-plan-disabled.json
{
  "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

Send example to Inspect → View as JSON

reserve.plan.expired

documented official schema

Reserve plan expires

Identified by type field in the body Resource reserve

stripe-reserve-plan-expired.json
{
  "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

Send example to Inspect → View as JSON

reserve.plan.updated

documented official schema

Reserve plan changes

Identified by type field in the body Resource reserve

stripe-reserve-plan-updated.json
{
  "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

Send example to Inspect → View as JSON

reserve.release.created

documented official schema

Reserve release created

Identified by type field in the body Resource reserve

stripe-reserve-release-created.json
{
  "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

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.