Stripe billing webhook events
Stripe sends 8 billing events, including billing.alert.triggered, billing.credit_balance_transaction.created and billing.credit_grant.created.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
billing.alert.triggered
documented official schema
billing.alert.triggered Usage reaches your custom alert threshold
Identified by type field in the body
Resource billing
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"alert": { … },
"created": 1028554472,
"customer": "customer",
"livemode": true,
"object": "billing.alert_triggered",
"value": 111972721
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "billing.alert.triggered"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.customer | string | customer |
data.object.created | integer | 1028554472 |
Full schema: 47 fields.
From Stripe docs
-
Content type
application/json
billing.credit_balance_transaction.created
documented official schema
billing.credit_balance_transaction.created Credit balance transaction recorded
Identified by type field in the body
Resource billing
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"created": 1028554472,
"credit": { … },
"credit_grant": "credit_grant",
"debit": { … },
"effective_at": 247108043,
"id": "obj_123",
"livemode": true,
"object": "billing.credit_balance_transaction",
"test_clock": null,
"type": null
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "billing.credit_balance_transaction.created"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | obj_123 |
data.object.created | integer | 1028554472 |
Full schema: 40 fields.
From Stripe docs
-
Content type
application/json
billing.credit_grant.created
documented official schema
billing.credit_grant.created Credit grant created
Identified by type field in the body
Resource billing
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": { … },
"applicability_config": { … },
"category": "paid",
"created": 1028554472,
"customer": { … },
"effective_at": null,
"expires_at": null,
"id": "obj_123",
"livemode": true,
"metadata": { … }
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "billing.credit_grant.created"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | obj_123 |
data.object.created | integer | 1028554472 |
Full schema: 44 fields.
From Stripe docs
-
Content type
application/json
billing.credit_grant.updated
documented official schema
billing.credit_grant.updated Credit grant changes
Identified by type field in the body
Resource billing
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": { … },
"applicability_config": { … },
"category": "paid",
"created": 1028554472,
"customer": { … },
"effective_at": null,
"expires_at": null,
"id": "obj_123",
"livemode": true,
"metadata": { … }
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "billing.credit_grant.updated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | obj_123 |
data.object.created | integer | 1028554472 |
Full schema: 44 fields.
From Stripe docs
-
Content type
application/json
billing.meter.created
documented official schema
billing.meter.created Usage meter created
Identified by type field in the body
Resource billing
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"created": 1234567890,
"customer_mapping": { … },
"default_aggregation": { … },
"display_name": "test-meter",
"event_name": "test-meter-event-name",
"event_time_window": null,
"id": "meter_123",
"livemode": true,
"object": "billing.meter",
"status": "active",
"status_transitions": { … }
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "billing.meter.created"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | meter_123 |
data.object.status | string | active |
data.object.created | integer | 1234567890 |
Full schema: 30 fields.
From Stripe docs
-
Content type
application/json
billing.meter.deactivated
documented official schema
billing.meter.deactivated Usage meter deactivated
Identified by type field in the body
Resource billing
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"created": 1234567890,
"customer_mapping": { … },
"default_aggregation": { … },
"display_name": "test-meter",
"event_name": "test-meter-event-name",
"event_time_window": null,
"id": "meter_123",
"livemode": true,
"object": "billing.meter",
"status": "active",
"status_transitions": { … }
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "billing.meter.deactivated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | meter_123 |
data.object.status | string | active |
data.object.created | integer | 1234567890 |
Full schema: 30 fields.
From Stripe docs
-
Content type
application/json
billing.meter.reactivated
documented official schema
billing.meter.reactivated Usage meter reactivated
Identified by type field in the body
Resource billing
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"created": 1234567890,
"customer_mapping": { … },
"default_aggregation": { … },
"display_name": "test-meter",
"event_name": "test-meter-event-name",
"event_time_window": null,
"id": "meter_123",
"livemode": true,
"object": "billing.meter",
"status": "active",
"status_transitions": { … }
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "billing.meter.reactivated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | meter_123 |
data.object.status | string | active |
data.object.created | integer | 1234567890 |
Full schema: 30 fields.
From Stripe docs
-
Content type
application/json
billing.meter.updated
documented official schema
billing.meter.updated Usage meter changes
Identified by type field in the body
Resource billing
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"created": 1234567890,
"customer_mapping": { … },
"default_aggregation": { … },
"display_name": "test-meter",
"event_name": "test-meter-event-name",
"event_time_window": null,
"id": "meter_123",
"livemode": true,
"object": "billing.meter",
"status": "active",
"status_transitions": { … }
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "billing.meter.updated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | meter_123 |
data.object.status | string | active |
data.object.created | integer | 1234567890 |
Full schema: 30 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.