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
customer.created New customer created
Identified by type field in the body
Resource customer
{
"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
customer.deleted
documented official schema
customer.deleted Customer deleted
Identified by type field in the body
Resource customer
{
"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
customer.discount.created
documented official schema
customer.discount.created Coupon applied to a customer
Identified by type field in the body
Resource customer
{
"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
customer.discount.deleted
documented official schema
customer.discount.deleted Coupon removed from a customer
Identified by type field in the body
Resource customer
{
"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
customer.discount.updated
documented official schema
customer.discount.updated Customer moves from one coupon to another
Identified by type field in the body
Resource customer
{
"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
customer.source.created
documented official schema
customer.source.created Payment source added to a customer
Identified by type field in the body
Resource customer
{
"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
customer.source.deleted
documented official schema
customer.source.deleted Payment source removed from a customer
Identified by type field in the body
Resource customer
{
"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
customer.source.expiring
documented official schema
customer.source.expiring Card or source expires at the end of the month (legacy integrations only)
Identified by type field in the body
Resource customer
{
"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
customer.source.updated
documented official schema
customer.source.updated Customer's payment source details change
Identified by type field in the body
Resource customer
{
"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
customer.tax_id.created
documented official schema
customer.tax_id.created Tax ID added to a customer
Identified by type field in the body
Resource customer
{
"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
customer.tax_id.deleted
documented official schema
customer.tax_id.deleted Tax ID removed from a customer
Identified by type field in the body
Resource customer
{
"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
customer.tax_id.updated
documented official schema
customer.tax_id.updated Customer's tax ID changes
Identified by type field in the body
Resource customer
{
"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
customer.updated
verified from a captured delivery
customer.updated Any customer property changes
Identified by type field in the body
Resource customer
{
"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
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.