Stripe price webhook events
Stripe sends 3 price events: price.created, price.deleted and price.updated.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
price.created
documented official schema
price.created Price created
Identified by type field in the body
Resource price
stripe-price-created.json
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"active": true,
"billing_scheme": "per_unit",
"created": 1234567890,
"currency": "usd",
"custom_unit_amount": { … },
"id": "price_1PgafmB7WZ01zgkW6dKueIc5",
"livemode": false,
"lookup_key": null,
"metadata": { … },
"nickname": null,
"type": "recurring",
"unit_amount": 2000
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "price.created"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | price_1PgafmB7WZ01zgkW6dKueIc5 |
data.object.type | string | recurring |
data.object.unit_amount | integer | 2000 |
data.object.created | integer | 1234567890 |
Full schema: 41 fields.
From Stripe docs
-
Content type
application/json
price.deleted
documented official schema
price.deleted Price deleted
Identified by type field in the body
Resource price
stripe-price-deleted.json
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"active": true,
"billing_scheme": "per_unit",
"created": 1234567890,
"currency": "usd",
"custom_unit_amount": { … },
"id": "price_1PgafmB7WZ01zgkW6dKueIc5",
"livemode": false,
"lookup_key": null,
"metadata": { … },
"nickname": null,
"type": "recurring",
"unit_amount": 2000
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "price.deleted"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | price_1PgafmB7WZ01zgkW6dKueIc5 |
data.object.type | string | recurring |
data.object.unit_amount | integer | 2000 |
data.object.created | integer | 1234567890 |
Full schema: 41 fields.
From Stripe docs
-
Content type
application/json
price.updated
documented official schema
price.updated Price changes
Identified by type field in the body
Resource price
stripe-price-updated.json
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"active": true,
"billing_scheme": "per_unit",
"created": 1234567890,
"currency": "usd",
"custom_unit_amount": { … },
"id": "price_1PgafmB7WZ01zgkW6dKueIc5",
"livemode": false,
"lookup_key": null,
"metadata": { … },
"nickname": null,
"type": "recurring",
"unit_amount": 2000
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "price.updated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | price_1PgafmB7WZ01zgkW6dKueIc5 |
data.object.type | string | recurring |
data.object.unit_amount | integer | 2000 |
data.object.created | integer | 1234567890 |
Full schema: 41 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.