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)

New customer created

Identified by x-shopify-topic header Resource customers

shopify-customers-create.json
{
  "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

Send example to Inspect → View as JSON

customers/update

documented from Shopify docs (example)

Customer details change

Identified by x-shopify-topic header Resource customers

shopify-customers-update.json
{
  "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

Send example to Inspect → View as JSON

customer_account_settings/update

documented from Shopify docs (example)

Merchant changes customer account settings

Identified by x-shopify-topic header Resource customers

shopify-customer-account-settings-update.json
{
  "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

Send example to Inspect → View as JSON

customer_groups/create

documented from Shopify docs (example)

Customer saved search created

Identified by x-shopify-topic header Resource customers

shopify-customer-groups-create.json
{
  "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

Send example to Inspect → View as JSON

customer_groups/delete

documented from Shopify docs (example)

Customer saved search deleted

Identified by x-shopify-topic header Resource customers

shopify-customer-groups-delete.json
{
  "id": 239443597569284770
}

Key fields

Field Type Example
id integer 239443597569284770

Full schema: 1 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

customer_groups/update

documented from Shopify docs (example)

Customer saved search changes

Identified by x-shopify-topic header Resource customers

shopify-customer-groups-update.json
{
  "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

Send example to Inspect → View as JSON

customer.joined_segment

documented from Shopify docs (example)

Customer joins a segment

Identified by x-shopify-topic header Resource customers

shopify-customer-joined-segment.json
{
  "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

Send example to Inspect → View as JSON

customer.left_segment

documented from Shopify docs (example)

Customer leaves a segment

Identified by x-shopify-topic header Resource customers

shopify-customer-left-segment.json
{
  "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

Send example to Inspect → View as JSON

customer_payment_methods/create

documented from Shopify docs (example)

New customer payment method created

Identified by x-shopify-topic header Resource customers

shopify-customer-payment-methods-create.json
{
  "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

Send example to Inspect → View as JSON

customer_payment_methods/revoke

documented from Shopify docs (example)

Customer payment method revoked

Identified by x-shopify-topic header Resource customers

shopify-customer-payment-methods-revoke.json
{
  "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

Send example to Inspect → View as JSON

customer_payment_methods/update

documented from Shopify docs (example)

Customer payment method changes

Identified by x-shopify-topic header Resource customers

shopify-customer-payment-methods-update.json
{
  "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

Send example to Inspect → View as JSON

customer.tags_added

documented from Shopify docs (example)

Tags added to a customer

Identified by x-shopify-topic header Resource customers

shopify-customer-tags-added.json
{
  "customerId": "gid://shopify/Customer/1",
  "tags": [ … ],
  "occurredAt": "2005-05-05T00:00:00.000Z"
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

customer.tags_removed

documented from Shopify docs (example)

Tags removed from a customer

Identified by x-shopify-topic header Resource customers

shopify-customer-tags-removed.json
{
  "customerId": "gid://shopify/Customer/1",
  "tags": [ … ],
  "occurredAt": "2005-05-05T00:00:00.000Z"
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

customers/delete

documented from Shopify docs (example)

Customer is deleted

Identified by x-shopify-topic header Resource customers

shopify-customers-delete.json
{
  "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

Send example to Inspect → View as JSON

customers/disable

documented from Shopify docs (example)

Customer account is disabled

Identified by x-shopify-topic header Resource customers

shopify-customers-disable.json
{
  "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

Send example to Inspect → View as JSON

customers_email_marketing_consent/update

documented from Shopify docs (example)

Customer's email marketing consent changes

Identified by x-shopify-topic header Resource customers

shopify-customers-email-marketing-consent-update.json
{
  "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

Send example to Inspect → View as JSON

customers/enable

documented from Shopify docs (example)

Customer account is enabled

Identified by x-shopify-topic header Resource customers

shopify-customers-enable.json
{
  "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

Send example to Inspect → View as JSON

customers_marketing_consent/update

documented from Shopify docs (example)

Customer's SMS marketing consent changes

Identified by x-shopify-topic header Resource customers

shopify-customers-marketing-consent-update.json
{
  "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

Send example to Inspect → View as JSON

customers/merge

documented from Shopify docs (example)

Two customers merged into one

Identified by x-shopify-topic header Resource customers

shopify-customers-merge.json
{
  "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

Send example to Inspect → View as JSON

customers/purchasing_summary

documented from Shopify docs (example)

Customer's sales history changes

Identified by x-shopify-topic header Resource customers

shopify-customers-purchasing-summary.json
{
  "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

Send example to Inspect → View as JSON

customers/data_request

verified from a captured delivery

Store owner passes on a customer's request for their data

Identified by x-shopify-topic header Resource customers

shopify-customers-data-request.json
{
  "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

Send example to Inspect → View as JSON

customers/redact

verified from a captured delivery

Store owner asks you to delete a customer's data

Identified by x-shopify-topic header Resource customers

shopify-customers-redact.json
{
  "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

Send example to Inspect → View as JSON

customers_whats_app_marketing_consent/update

documented from Shopify docs (example)

Customer's WhatsApp marketing consent changes

Identified by x-shopify-topic header Resource customers

shopify-customers-whats-app-marketing-consent-update.json
{
  "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

Send example to Inspect → View as JSON

segments/create

documented from Shopify docs (example)

New segment created

Identified by x-shopify-topic header Resource customers

shopify-segments-create.json
{
  "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

Send example to Inspect → View as JSON

segments/delete

documented from Shopify docs (example)

Segment is deleted

Identified by x-shopify-topic header Resource customers

shopify-segments-delete.json
{
  "id": 1
}

Key fields

Field Type Example
id integer 1

Full schema: 1 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

segments/update

documented from Shopify docs (example)

Segment details change

Identified by x-shopify-topic header Resource customers

shopify-segments-update.json
{
  "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

Send example to Inspect → View as 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.

Not affiliated with Shopify. Facts are compiled from public sources and linked inline.