{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Stripe.",
  "vendor": "stripe",
  "event": "billing.alert.triggered",
  "resource": "billing",
  "url": "https://hookdeck.com/webhooks/stripe/events/billing#billing.alert.triggered",
  "description": "Usage reaches your custom alert threshold",
  "trigger": null,
  "listed_in": "https://docs.stripe.com/api/events/types",
  "confidence": "documented",
  "schema_source": "official schema",
  "identified_by": "type field in the body",
  "payload": {
    "provenance": "vendor-source",
    "value_realism": "doc-example-values",
    "field_count": 47,
    "key_fields": [
      {
        "path": "data.object.customer",
        "type": "string",
        "example": "customer"
      },
      {
        "path": "data.object.created",
        "type": "integer",
        "example": "1028554472"
      }
    ],
    "delivery": {
      "title": "From Stripe docs",
      "content_type": "application/json",
      "headers": []
    },
    "body": {
      "api_version": "2026-10-28.endive",
      "created": 1234567890,
      "data": {
        "object": {
          "alert": {
            "alert_type": "usage_threshold",
            "id": "obj_123",
            "livemode": true,
            "object": "billing.alert",
            "status": null,
            "title": "title",
            "usage_threshold": {
              "filters": null,
              "gte": 102680,
              "meter": {
                "created": 1028554472,
                "customer_mapping": {
                  "event_payload_key": "event_payload_key",
                  "type": "by_id"
                },
                "default_aggregation": {
                  "formula": "sum"
                },
                "display_name": "display_name",
                "event_name": "event_name",
                "event_time_window": null,
                "id": "obj_123",
                "livemode": true,
                "object": "billing.meter",
                "status": "active",
                "status_transitions": {
                  "deactivated_at": null
                },
                "updated": 234430277,
                "value_settings": {
                  "event_payload_key": "event_payload_key"
                }
              },
              "recurrence": "one_time"
            }
          },
          "created": 1028554472,
          "customer": "customer",
          "livemode": true,
          "object": "billing.alert_triggered",
          "value": 111972721
        }
      },
      "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
      "livemode": false,
      "object": "event",
      "pending_webhooks": 0,
      "request": {
        "id": null,
        "idempotency_key": null
      },
      "type": "billing.alert.triggered"
    }
  }
}