# Stripe customer webhook events

Stripe sends 13 customer events, including `customer.created`, `customer.deleted` and `customer.discount.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)

## customer.created

Confidence: verified · Schema: from a captured delivery

New customer created

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

```json
{
  "id": "evt_1MhUT6E0b6fckueSqWR0Bec4",
  "object": "event",
  "api_version": "2022-11-15",
  "created": 1677833998,
  "data": {
    "object": {
      "id": "cus_NSPHp4fOlXGw8P",
      "object": "customer",
      "address": { … },
      "balance": 0,
      "created": 1677833998,
      "currency": null,
      "default_source": null,
      "delinquent": false,
      "description": null,
      "discount": null
    }
  },
  "livemode": false,
  "pending_webhooks": 3,
  "request": { … },
  "type": "customer.created"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `cus_NSPHp4fOlXGw8P` |
| `data.object.created` | integer | `1677833998` |

Seen in a captured delivery: content type `application/json; charset=utf-8` · API version `2022-11-15` · headers `user-agent`, `content-type`

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

## customer.deleted

Confidence: documented · Schema: official schema

Customer deleted

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "address": { … },
      "balance": 0,
      "created": 1234567890,
      "currency": "usd",
      "default_source": null,
      "delinquent": false,
      "description": null,
      "discount": { … },
      "email": null,
      "id": "cus_QXg1o8vcGmoR32"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.deleted"
}
```

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

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

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-deleted.json)

## customer.discount.created

Confidence: documented · Schema: official schema

Coupon applied to a customer

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "checkout_session": null,
      "customer": "cus_QXg1o8vcGmoR32",
      "end": 1234567890,
      "id": "di_1Pgc6rB7WZ01zgkW7Al8Fal9",
      "invoice": null,
      "invoice_item": null,
      "object": "discount",
      "promotion_code": null,
      "start": 1234567890,
      "subscription": null
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.discount.created"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `di_1Pgc6rB7WZ01zgkW7Al8Fal9` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |

From Stripe docs: content type `application/json`

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

## customer.discount.deleted

Confidence: documented · Schema: official schema

Coupon removed from a customer

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "checkout_session": null,
      "customer": "cus_QXg1o8vcGmoR32",
      "end": 1234567890,
      "id": "di_1Pgc6rB7WZ01zgkW7Al8Fal9",
      "invoice": null,
      "invoice_item": null,
      "object": "discount",
      "promotion_code": null,
      "start": 1234567890,
      "subscription": null
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.discount.deleted"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-discount-deleted.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `di_1Pgc6rB7WZ01zgkW7Al8Fal9` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-discount-deleted.json)

## customer.discount.updated

Confidence: documented · Schema: official schema

Customer moves from one coupon to another

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "checkout_session": null,
      "customer": "cus_QXg1o8vcGmoR32",
      "end": 1234567890,
      "id": "di_1Pgc6rB7WZ01zgkW7Al8Fal9",
      "invoice": null,
      "invoice_item": null,
      "object": "discount",
      "promotion_code": null,
      "start": 1234567890,
      "subscription": null
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.discount.updated"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `di_1Pgc6rB7WZ01zgkW7Al8Fal9` |
| `data.object.customer` | string | `cus_QXg1o8vcGmoR32` |

From Stripe docs: content type `application/json`

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

## customer.source.created

Confidence: documented · Schema: official schema

Payment source added to a customer

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder_name": "Jane Austen",
      "account_holder_type": "company",
      "account_type": null,
      "bank_name": "STRIPE TEST BANK",
      "country": "US",
      "currency": "usd",
      "customer": null,
      "fingerprint": "AuoSJ18zsVWV9SPc",
      "id": "ba_1PgagAB7WZ01zgkWr3DySp2Q",
      "status": "new"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.source.created"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `ba_1PgagAB7WZ01zgkWr3DySp2Q` |
| `data.object.status` | string | `new` |

From Stripe docs: content type `application/json`

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

## customer.source.deleted

Confidence: documented · Schema: official schema

Payment source removed from a customer

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder_name": "Jane Austen",
      "account_holder_type": "company",
      "account_type": null,
      "bank_name": "STRIPE TEST BANK",
      "country": "US",
      "currency": "usd",
      "customer": null,
      "fingerprint": "AuoSJ18zsVWV9SPc",
      "id": "ba_1PgagAB7WZ01zgkWr3DySp2Q",
      "status": "new"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.source.deleted"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-source-deleted.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `ba_1PgagAB7WZ01zgkWr3DySp2Q` |
| `data.object.status` | string | `new` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-source-deleted.json)

## customer.source.expiring

Confidence: documented · Schema: official schema

Card or source expires at the end of the month (legacy integrations only)

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "address_city": null,
      "address_country": null,
      "address_line1": null,
      "address_line1_check": null,
      "address_line2": null,
      "address_state": null,
      "address_zip": null,
      "address_zip_check": null,
      "id": "card_1PgaftB7WZ01zgkWm3waTcFp"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.source.expiring"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-source-expiring.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `card_1PgaftB7WZ01zgkWm3waTcFp` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-source-expiring.json)

## customer.source.updated

Confidence: documented · Schema: official schema

Customer's payment source details change

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder_name": "Jane Austen",
      "account_holder_type": "company",
      "account_type": null,
      "bank_name": "STRIPE TEST BANK",
      "country": "US",
      "currency": "usd",
      "customer": null,
      "fingerprint": "AuoSJ18zsVWV9SPc",
      "id": "ba_1PgagAB7WZ01zgkWr3DySp2Q",
      "status": "new"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.source.updated"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `ba_1PgagAB7WZ01zgkWr3DySp2Q` |
| `data.object.status` | string | `new` |

From Stripe docs: content type `application/json`

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

## customer.tax_id.created

Confidence: documented · Schema: official schema

Tax ID added to a customer

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "country": "DE",
      "created": 1234567890,
      "customer": "cus_QXg1o8vcGmoR32",
      "id": "txi_1Pgc6sB7WZ01zgkWXkvC78jZ",
      "livemode": false,
      "object": "tax_id",
      "owner": { … },
      "type": "eu_vat",
      "value": "DE123456789",
      "verification": { … },
      "customer_account": null
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.tax_id.created"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `txi_1Pgc6sB7WZ01zgkWXkvC78jZ` |
| `data.object.type` | string | `eu_vat` |
| `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/customer-tax-id-created.json)

## customer.tax_id.deleted

Confidence: documented · Schema: official schema

Tax ID removed from a customer

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "country": "DE",
      "created": 1234567890,
      "customer": "cus_QXg1o8vcGmoR32",
      "id": "txi_1Pgc6sB7WZ01zgkWXkvC78jZ",
      "livemode": false,
      "object": "tax_id",
      "owner": { … },
      "type": "eu_vat",
      "value": "DE123456789",
      "verification": { … },
      "customer_account": null
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.tax_id.deleted"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/customer-tax-id-deleted.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `txi_1Pgc6sB7WZ01zgkWXkvC78jZ` |
| `data.object.type` | string | `eu_vat` |
| `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/customer-tax-id-deleted.json)

## customer.tax_id.updated

Confidence: documented · Schema: official schema

Customer's tax ID changes

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

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "country": "DE",
      "created": 1234567890,
      "customer": "cus_QXg1o8vcGmoR32",
      "id": "txi_1Pgc6sB7WZ01zgkWXkvC78jZ",
      "livemode": false,
      "object": "tax_id",
      "owner": { … },
      "type": "eu_vat",
      "value": "DE123456789",
      "verification": { … },
      "customer_account": null
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "customer.tax_id.updated"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `txi_1Pgc6sB7WZ01zgkWXkvC78jZ` |
| `data.object.type` | string | `eu_vat` |
| `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/customer-tax-id-updated.json)

## customer.updated

Confidence: verified · Schema: from a captured delivery

Any customer property changes

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

```json
{
  "id": "evt_1MhUT6E0b6fckueSfmuGgXWq",
  "object": "event",
  "api_version": "2022-11-15",
  "created": 1677833999,
  "data": {
    "object": {
      "id": "cus_NSPHp4fOlXGw8P",
      "object": "customer",
      "address": { … },
      "balance": 0,
      "created": 1677833998,
      "currency": "usd",
      "default_source": null,
      "delinquent": false,
      "description": null,
      "discount": null
    },
    "previous_attributes": { … }
  },
  "livemode": false,
  "pending_webhooks": 3,
  "request": { … },
  "type": "customer.updated"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `cus_NSPHp4fOlXGw8P` |
| `data.object.created` | integer | `1677833998` |

Seen in a captured delivery: content type `application/json; charset=utf-8` · API version `2022-11-15` · headers `user-agent`, `content-type`

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