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

Usage reaches your custom alert threshold

Identified by type field in the body Resource billing

stripe-billing-alert-triggered.json
{
  "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

Send example to Inspect → View as JSON

billing.credit_balance_transaction.created

documented official schema

Credit balance transaction recorded

Identified by type field in the body Resource billing

stripe-billing-credit-balance-transaction-created.json
{
  "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

Send example to Inspect → View as JSON

billing.credit_grant.created

documented official schema

Credit grant created

Identified by type field in the body Resource billing

stripe-billing-credit-grant-created.json
{
  "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

Send example to Inspect → View as JSON

billing.credit_grant.updated

documented official schema

Credit grant changes

Identified by type field in the body Resource billing

stripe-billing-credit-grant-updated.json
{
  "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

Send example to Inspect → View as JSON

billing.meter.created

documented official schema

Usage meter created

Identified by type field in the body Resource billing

stripe-billing-meter-created.json
{
  "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

Send example to Inspect → View as JSON

billing.meter.deactivated

documented official schema

Usage meter deactivated

Identified by type field in the body Resource billing

stripe-billing-meter-deactivated.json
{
  "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

Send example to Inspect → View as JSON

billing.meter.reactivated

documented official schema

Usage meter reactivated

Identified by type field in the body Resource billing

stripe-billing-meter-reactivated.json
{
  "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

Send example to Inspect → View as JSON

billing.meter.updated

documented official schema

Usage meter changes

Identified by type field in the body Resource billing

stripe-billing-meter-updated.json
{
  "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

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.