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 →

customer.created

verified from a captured delivery

New customer created

Identified by type field in the body Resource customer

stripe-customer-created.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"
}

Key fields

Field Type Example
data.object.id string cus_NSPHp4fOlXGw8P
data.object.created integer 1677833998

Full schema: 45 fields.

Seen in a captured delivery

  • Content type application/json; charset=utf-8
  • API version 2022-11-15
  • Headers user-agent , content-type

Send example to Inspect → View as JSON

customer.deleted

documented official schema

Customer deleted

Identified by type field in the body Resource customer

stripe-customer-deleted.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"
}

Key fields

Field Type Example
data.object.id string cus_QXg1o8vcGmoR32
data.object.created integer 1234567890

Full schema: 61 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.discount.created

documented official schema

Coupon applied to a customer

Identified by type field in the body Resource customer

stripe-customer-discount-created.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"
}

Key fields

Field Type Example
data.object.id string di_1Pgc6rB7WZ01zgkW7Al8Fal9
data.object.customer string cus_QXg1o8vcGmoR32

Full schema: 27 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.discount.deleted

documented official schema

Coupon removed from a customer

Identified by type field in the body Resource customer

stripe-customer-discount-deleted.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"
}

Key fields

Field Type Example
data.object.id string di_1Pgc6rB7WZ01zgkW7Al8Fal9
data.object.customer string cus_QXg1o8vcGmoR32

Full schema: 27 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.discount.updated

documented official schema

Customer moves from one coupon to another

Identified by type field in the body Resource customer

stripe-customer-discount-updated.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"
}

Key fields

Field Type Example
data.object.id string di_1Pgc6rB7WZ01zgkW7Al8Fal9
data.object.customer string cus_QXg1o8vcGmoR32

Full schema: 27 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.source.created

documented official schema

Payment source added to a customer

Identified by type field in the body Resource customer

stripe-customer-source-created.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"
}

Key fields

Field Type Example
data.object.id string ba_1PgagAB7WZ01zgkWr3DySp2Q
data.object.status string new

Full schema: 26 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.source.deleted

documented official schema

Payment source removed from a customer

Identified by type field in the body Resource customer

stripe-customer-source-deleted.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"
}

Key fields

Field Type Example
data.object.id string ba_1PgagAB7WZ01zgkWr3DySp2Q
data.object.status string new

Full schema: 26 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.source.expiring

documented official schema

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

Identified by type field in the body Resource customer

stripe-customer-source-expiring.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"
}

Key fields

Field Type Example
data.object.id string card_1PgaftB7WZ01zgkWm3waTcFp

Full schema: 36 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.source.updated

documented official schema

Customer's payment source details change

Identified by type field in the body Resource customer

stripe-customer-source-updated.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"
}

Key fields

Field Type Example
data.object.id string ba_1PgagAB7WZ01zgkWr3DySp2Q
data.object.status string new

Full schema: 26 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.tax_id.created

documented official schema

Tax ID added to a customer

Identified by type field in the body Resource customer

stripe-customer-tax-id-created.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"
}

Key fields

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

Full schema: 29 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.tax_id.deleted

documented official schema

Tax ID removed from a customer

Identified by type field in the body Resource customer

stripe-customer-tax-id-deleted.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"
}

Key fields

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

Full schema: 29 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.tax_id.updated

documented official schema

Customer's tax ID changes

Identified by type field in the body Resource customer

stripe-customer-tax-id-updated.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"
}

Key fields

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

Full schema: 29 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.updated

verified from a captured delivery

Any customer property changes

Identified by type field in the body Resource customer

stripe-customer-updated.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"
}

Key fields

Field Type Example
data.object.id string cus_NSPHp4fOlXGw8P
data.object.created integer 1677833998

Full schema: 47 fields.

Seen in a captured delivery

  • Content type application/json; charset=utf-8
  • API version 2022-11-15
  • Headers user-agent , content-type

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.