# Stripe billing_portal webhook events

Stripe sends 3 billing_portal events: `billing_portal.configuration.created`, `billing_portal.configuration.updated` and `billing_portal.session.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_portal.configuration.created

Confidence: documented · Schema: official schema

Customer portal configuration created

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "active": true,
      "application": null,
      "business_profile": { … },
      "created": 1234567890,
      "default_return_url": null,
      "features": { … },
      "id": "bpc_1Pgc70B7WZ01zgkWSnFO04Vt",
      "is_default": true,
      "livemode": true,
      "login_page": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "billing_portal.configuration.created"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `bpc_1Pgc70B7WZ01zgkWSnFO04Vt` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

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

## billing_portal.configuration.updated

Confidence: documented · Schema: official schema

Customer portal configuration changes

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "active": true,
      "application": null,
      "business_profile": { … },
      "created": 1234567890,
      "default_return_url": null,
      "features": { … },
      "id": "bpc_1Pgc70B7WZ01zgkWSnFO04Vt",
      "is_default": true,
      "livemode": true,
      "login_page": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "billing_portal.configuration.updated"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `bpc_1Pgc70B7WZ01zgkWSnFO04Vt` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

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

## billing_portal.session.created

Confidence: documented · Schema: official schema

Customer portal session starts

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "configuration": "bpc_1Pgc7HB7WZ01zgkWxH2EPWRX",
      "created": 1234567890,
      "customer": "cus_QXg1o8vcGmoR32",
      "flow": { … },
      "id": "bps_1Pgc7HB7WZ01zgkWNs8s9Auh",
      "livemode": true,
      "locale": null,
      "object": "billing_portal.session",
      "on_behalf_of": null,
      "return_url": "https://example.com/account",
      "url": "https://sangeekp-15t6ai--customer_portal-mydev.dev.stripe.me/session/{SESSION_SECRET}"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "billing_portal.session.created"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `bps_1Pgc7HB7WZ01zgkWNs8s9Auh` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/billing-portal-session-created.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)
