# 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](https://hookdeck.com/webhooks/stripe/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill stripe-webhooks` ([details](https://hookdeck.com/webhooks/stripe/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Stripe's official docs](https://docs.stripe.com/event-destinations).

[Overview](https://hookdeck.com/webhooks/stripe) · [Webhook events (246)](https://hookdeck.com/webhooks/stripe/events) · [MCP events](https://hookdeck.com/webhooks/stripe/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/stripe/verify) · [Production guide](https://hookdeck.com/webhooks/stripe/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/stripe/skill)

## billing.alert.triggered

Confidence: documented · Schema: official schema

Usage reaches your custom alert threshold

Identified by: type field in the body · Object: `billing`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-alert-triggered.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.customer` | string | `customer` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-alert-triggered.json)

## billing.credit_balance_transaction.created

Confidence: documented · Schema: official schema

Credit balance transaction recorded

Identified by: type field in the body · Object: `billing`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-credit-balance-transaction-created.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `obj_123` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-credit-balance-transaction-created.json)

## billing.credit_grant.created

Confidence: documented · Schema: official schema

Credit grant created

Identified by: type field in the body · Object: `billing`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-credit-grant-created.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `obj_123` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-credit-grant-created.json)

## billing.credit_grant.updated

Confidence: documented · Schema: official schema

Credit grant changes

Identified by: type field in the body · Object: `billing`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-credit-grant-updated.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `obj_123` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-credit-grant-updated.json)

## billing.meter.created

Confidence: documented · Schema: official schema

Usage meter created

Identified by: type field in the body · Object: `billing`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-meter-created.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `meter_123` |
| `data.object.status` | string | `active` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-meter-created.json)

## billing.meter.deactivated

Confidence: documented · Schema: official schema

Usage meter deactivated

Identified by: type field in the body · Object: `billing`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-meter-deactivated.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `meter_123` |
| `data.object.status` | string | `active` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-meter-deactivated.json)

## billing.meter.reactivated

Confidence: documented · Schema: official schema

Usage meter reactivated

Identified by: type field in the body · Object: `billing`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-meter-reactivated.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `meter_123` |
| `data.object.status` | string | `active` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-meter-reactivated.json)

## billing.meter.updated

Confidence: documented · Schema: official schema

Usage meter changes

Identified by: type field in the body · Object: `billing`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-meter-updated.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `meter_123` |
| `data.object.status` | string | `active` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-meter-updated.json)

---

Not affiliated with Stripe. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/stripe.json) · [Report a correction](https://hookdeck.com/contact)
