Shopify customers webhook events
Shopify sends 26 customer events, covering accounts, marketing consent, saved searches, payment methods, segments and tags. customers/update is the broadest, and customers/data_request and customers/redact are mandatory for App Store apps.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
customers/create
documented from Shopify docs (example)
customers/create New customer created
Identified by x-shopify-topic header
Resource customers
{
"id": 706405506930370000,
"email": "bob@biller.com",
"accepts_marketing": true,
"created_at": null,
"updated_at": null,
"first_name": "Bob",
"last_name": "Biller",
"orders_count": 0,
"state": "disabled",
"total_spent": "0.00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 706405506930370000 |
state | string | disabled |
Full schema: 34 fields.
From Shopify docs
-
Content type
application/json
customers/update
documented from Shopify docs (example)
customers/update Customer details change
Identified by x-shopify-topic header
Resource customers
{
"id": 706405506930370000,
"email": "bob@biller.com",
"accepts_marketing": true,
"created_at": null,
"updated_at": null,
"first_name": "Bob",
"last_name": "Biller",
"orders_count": 0,
"state": "disabled",
"total_spent": "0.00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 706405506930370000 |
state | string | disabled |
Full schema: 34 fields.
From Shopify docs
-
Content type
application/json
customer_account_settings/update
documented from Shopify docs (example)
customer_account_settings/update Merchant changes customer account settings
Identified by x-shopify-topic header
Resource customers
{
"url": null,
"customer_accounts_version": "classic",
"login_required_at_checkout": true,
"login_links_visible_on_storefront_and_checkout": true
} From Shopify docs
-
Content type
application/json
customer_groups/create
documented from Shopify docs (example)
customer_groups/create Customer saved search created
Identified by x-shopify-topic header
Resource customers
{
"id": 239443597569284770,
"name": "Repeat Customers",
"created_at": "2023-02-20T20:29:25-05:00",
"updated_at": "2023-02-20T20:29:25-05:00",
"query": "orders_count:>1"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 239443597569284770 |
created_at | string | 2023-02-20T20:29:25-05:00 |
Full schema: 5 fields.
From Shopify docs
-
Content type
application/json
customer_groups/delete
documented from Shopify docs (example)
customer_groups/delete Customer saved search deleted
Identified by x-shopify-topic header
Resource customers
{
"id": 239443597569284770
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 239443597569284770 |
Full schema: 1 fields.
From Shopify docs
-
Content type
application/json
customer_groups/update
documented from Shopify docs (example)
customer_groups/update Customer saved search changes
Identified by x-shopify-topic header
Resource customers
{
"id": 239443597569284770,
"name": "Repeat Customers",
"created_at": "2023-02-20T20:29:16-05:00",
"updated_at": "2023-02-20T20:29:16-05:00",
"query": "orders_count:>1"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 239443597569284770 |
created_at | string | 2023-02-20T20:29:16-05:00 |
Full schema: 5 fields.
From Shopify docs
-
Content type
application/json
customer.joined_segment
documented from Shopify docs (example)
customer.joined_segment Customer joins a segment
Identified by x-shopify-topic header
Resource customers
{
"shop_id": "gid://shopify/Shop/1",
"customer_id": "gid://shopify/Customer/2",
"segment_id": "gid://shopify/Segment/3"
} Key fields
| Field | Type | Example |
|---|---|---|
customer_id | string | gid://shopify/Customer/2 |
Full schema: 3 fields.
From Shopify docs
-
Content type
application/json
customer.left_segment
documented from Shopify docs (example)
customer.left_segment Customer leaves a segment
Identified by x-shopify-topic header
Resource customers
{
"shop_id": "gid://shopify/Shop/1",
"customer_id": "gid://shopify/Customer/2",
"segment_id": "gid://shopify/Segment/3"
} Key fields
| Field | Type | Example |
|---|---|---|
customer_id | string | gid://shopify/Customer/2 |
Full schema: 3 fields.
From Shopify docs
-
Content type
application/json
customer_payment_methods/create
documented from Shopify docs (example)
customer_payment_methods/create New customer payment method created
Identified by x-shopify-topic header
Resource customers
{
"admin_graphql_api_id": "gid://shopify/CustomerPaymentMethod/0eccccc666aac73efcd31094ddc4ebf0",
"token": "0eccccc666aac73efcd31094ddc4ebf0",
"customer_id": 82850125,
"admin_graphql_api_customer_id": "gid://shopify/Customer/82850125",
"instrument_type": "CustomerCreditCard",
"payment_instrument": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
customer_id | integer | 82850125 |
Full schema: 12 fields.
From Shopify docs
-
Content type
application/json
customer_payment_methods/revoke
documented from Shopify docs (example)
customer_payment_methods/revoke Customer payment method revoked
Identified by x-shopify-topic header
Resource customers
{
"admin_graphql_api_id": "gid://shopify/CustomerPaymentMethod/0eccccc666aac73efcd31094ddc4ebf0",
"token": "0eccccc666aac73efcd31094ddc4ebf0",
"customer_id": 82850125,
"admin_graphql_api_customer_id": "gid://shopify/Customer/82850125",
"instrument_type": "CustomerCreditCard",
"payment_instrument": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
customer_id | integer | 82850125 |
Full schema: 12 fields.
From Shopify docs
-
Content type
application/json
customer_payment_methods/update
documented from Shopify docs (example)
customer_payment_methods/update Customer payment method changes
Identified by x-shopify-topic header
Resource customers
{
"admin_graphql_api_id": "gid://shopify/CustomerPaymentMethod/0eccccc666aac73efcd31094ddc4ebf0",
"token": "0eccccc666aac73efcd31094ddc4ebf0",
"customer_id": 82850125,
"admin_graphql_api_customer_id": "gid://shopify/Customer/82850125",
"instrument_type": "CustomerCreditCard",
"payment_instrument": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
customer_id | integer | 82850125 |
Full schema: 12 fields.
From Shopify docs
-
Content type
application/json
customer.tags_added
documented from Shopify docs (example)
customer.tags_added Tags added to a customer
Identified by x-shopify-topic header
Resource customers
{
"customerId": "gid://shopify/Customer/1",
"tags": [ … ],
"occurredAt": "2005-05-05T00:00:00.000Z"
} From Shopify docs
-
Content type
application/json
customer.tags_removed
documented from Shopify docs (example)
customer.tags_removed Tags removed from a customer
Identified by x-shopify-topic header
Resource customers
{
"customerId": "gid://shopify/Customer/1",
"tags": [ … ],
"occurredAt": "2005-05-05T00:00:00.000Z"
} From Shopify docs
-
Content type
application/json
customers/delete
documented from Shopify docs (example)
customers/delete Customer is deleted
Identified by x-shopify-topic header
Resource customers
{
"id": 706405506930370000,
"phone": null,
"addresses": [ … ],
"accepts_marketing_updated_at": null,
"marketing_opt_in_level": null,
"tax_exemptions": [ … ],
"email_marketing_consent": null,
"sms_marketing_consent": null,
"admin_graphql_api_id": "gid://shopify/Customer/706405506930370084"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 706405506930370000 |
Full schema: 3 fields.
From Shopify docs
-
Content type
application/json
customers/disable
documented from Shopify docs (example)
customers/disable Customer account is disabled
Identified by x-shopify-topic header
Resource customers
{
"id": 706405506930370000,
"email": "bob@biller.com",
"accepts_marketing": true,
"created_at": null,
"updated_at": null,
"first_name": "Bob",
"last_name": "Biller",
"orders_count": 0,
"state": "disabled",
"total_spent": "0.00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 706405506930370000 |
state | string | disabled |
Full schema: 34 fields.
From Shopify docs
-
Content type
application/json
customers_email_marketing_consent/update
documented from Shopify docs (example)
customers_email_marketing_consent/update Customer's email marketing consent changes
Identified by x-shopify-topic header
Resource customers
{
"customer_id": 706405506930370000,
"email_address": null,
"email_marketing_consent": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
customer_id | integer | 706405506930370000 |
Full schema: 6 fields.
From Shopify docs
-
Content type
application/json
customers/enable
documented from Shopify docs (example)
customers/enable Customer account is enabled
Identified by x-shopify-topic header
Resource customers
{
"id": 706405506930370000,
"email": "bob@biller.com",
"accepts_marketing": true,
"created_at": null,
"updated_at": null,
"first_name": "Bob",
"last_name": "Biller",
"orders_count": 0,
"state": "disabled",
"total_spent": "0.00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 706405506930370000 |
state | string | disabled |
Full schema: 34 fields.
From Shopify docs
-
Content type
application/json
customers_marketing_consent/update
documented from Shopify docs (example)
customers_marketing_consent/update Customer's SMS marketing consent changes
Identified by x-shopify-topic header
Resource customers
{
"id": 706405506930370000,
"phone": null,
"sms_marketing_consent": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 706405506930370000 |
Full schema: 7 fields.
From Shopify docs
-
Content type
application/json
customers/merge
documented from Shopify docs (example)
customers/merge Two customers merged into one
Identified by x-shopify-topic header
Resource customers
{
"admin_graphql_api_customer_kept_id": "gid://shopify/Customer/1",
"admin_graphql_api_customer_deleted_id": "gid://shopify/Customer/2",
"admin_graphql_api_job_id": null,
"status": "failed",
"errors": [ … ]
} Key fields
| Field | Type | Example |
|---|---|---|
status | string | failed |
Full schema: 10 fields.
From Shopify docs
-
Content type
application/json
customers/purchasing_summary
documented from Shopify docs (example)
customers/purchasing_summary Customer's sales history changes
Identified by x-shopify-topic header
Resource customers
{
"customerId": "gid://shopify/Customer/1",
"numberOfOrders": 1,
"amountSpent": { … },
"lastOrderId": "gid://shopify/Order/1",
"occurredAt": "2005-05-05T05:00:00.000Z"
} From Shopify docs
-
Content type
application/json
customers/data_request
verified from a captured delivery
customers/data_request Store owner passes on a customer's request for their data
Identified by x-shopify-topic header
Resource customers
{
"shop_id": 954889,
"shop_domain": "{shop}.myshopify.com",
"customer": { … },
"orders_requested": [ … ],
"data_request": { … }
} Seen in a captured delivery
-
Content type
application/json -
API version
2026-07 -
Headers
user-agent,content-type,x-shopify-api-version,x-shopify-event-id,x-shopify-hmac-sha256,x-shopify-shop-domain,x-shopify-test,x-shopify-topic,x-shopify-triggered-at,x-shopify-webhook-id
customers/redact
verified from a captured delivery
customers/redact Store owner asks you to delete a customer's data
Identified by x-shopify-topic header
Resource customers
{
"shop_id": 954889,
"shop_domain": "{shop}.myshopify.com",
"customer": { … },
"orders_to_redact": [ … ]
} Seen in a captured delivery
-
Content type
application/json -
API version
2026-07 -
Headers
user-agent,content-type,x-shopify-api-version,x-shopify-event-id,x-shopify-hmac-sha256,x-shopify-shop-domain,x-shopify-test,x-shopify-topic,x-shopify-triggered-at,x-shopify-webhook-id
customers_whats_app_marketing_consent/update
documented from Shopify docs (example)
customers_whats_app_marketing_consent/update Customer's WhatsApp marketing consent changes
Identified by x-shopify-topic header
Resource customers
{
"customer_id": 706405506930370000,
"phone_number": null,
"whats_app_marketing_consent": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
customer_id | integer | 706405506930370000 |
Full schema: 7 fields.
From Shopify docs
-
Content type
application/json
segments/create
documented from Shopify docs (example)
segments/create New segment created
Identified by x-shopify-topic header
Resource customers
{
"id": 1,
"name": "Customers who have one order",
"query": "number_of_orders = 1",
"creationDate": "2022-01-01T00:00:00.000Z",
"lastEditDate": "2022-01-01T00:00:00.000Z"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 1 |
Full schema: 5 fields.
From Shopify docs
-
Content type
application/json
segments/delete
documented from Shopify docs (example)
segments/delete Segment is deleted
Identified by x-shopify-topic header
Resource customers
{
"id": 1
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 1 |
Full schema: 1 fields.
From Shopify docs
-
Content type
application/json
segments/update
documented from Shopify docs (example)
segments/update Segment details change
Identified by x-shopify-topic header
Resource customers
{
"id": 1,
"name": "Customers who have one order",
"query": "number_of_orders = 1",
"creationDate": "2005-05-05T00:00:00.000Z",
"lastEditDate": "2022-01-01T00:00:00.000Z"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 1 |
Full schema: 5 fields.
From Shopify docs
-
Content type
application/json
Route Shopify events by type.
Event Gateway receives every Shopify delivery and filters and routes it by event type, so each service gets only the events it handles.