# 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](https://hookdeck.com/webhooks/shopify/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill shopify-webhooks` ([details](https://hookdeck.com/webhooks/shopify/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Shopify's official docs](https://shopify.dev/docs/apps/build/webhooks/delivery-structure).

[Overview](https://hookdeck.com/webhooks/shopify) · [Webhook events (230)](https://hookdeck.com/webhooks/shopify/events) · [MCP events](https://hookdeck.com/webhooks/shopify/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/shopify/verify) · [Production guide](https://hookdeck.com/webhooks/shopify/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/shopify/skill)

## customers/create

Confidence: documented · Schema: from Shopify docs (example)

New customer created

Identified by: x-shopify-topic header · Object: `customers`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-create.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `706405506930370000` |
| `state` | string | `disabled` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-create.json)

## customers/update

Confidence: documented · Schema: from Shopify docs (example)

Customer details change

Identified by: x-shopify-topic header · Object: `customers`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-update.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `706405506930370000` |
| `state` | string | `disabled` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-update.json)

## customer_account_settings/update

Confidence: documented · Schema: from Shopify docs (example)

Merchant changes customer account settings

Identified by: x-shopify-topic header · Object: `customers`

```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`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-account-settings-update.json)

## customer_groups/create

Confidence: documented · Schema: from Shopify docs (example)

Customer saved search created

Identified by: x-shopify-topic header · Object: `customers`

```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 field | Type | Example |
|---|---|---|
| `id` | integer | `239443597569284770` |
| `created_at` | string | `2023-02-20T20:29:25-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-groups-create.json)

## customer_groups/delete

Confidence: documented · Schema: from Shopify docs (example)

Customer saved search deleted

Identified by: x-shopify-topic header · Object: `customers`

```json
{
  "id": 239443597569284770
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `239443597569284770` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-groups-delete.json)

## customer_groups/update

Confidence: documented · Schema: from Shopify docs (example)

Customer saved search changes

Identified by: x-shopify-topic header · Object: `customers`

```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 field | Type | Example |
|---|---|---|
| `id` | integer | `239443597569284770` |
| `created_at` | string | `2023-02-20T20:29:16-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-groups-update.json)

## customer.joined_segment

Confidence: documented · Schema: from Shopify docs (example)

Customer joins a segment

Identified by: x-shopify-topic header · Object: `customers`

```json
{
  "shop_id": "gid://shopify/Shop/1",
  "customer_id": "gid://shopify/Customer/2",
  "segment_id": "gid://shopify/Segment/3"
}
```



| Key field | Type | Example |
|---|---|---|
| `customer_id` | string | `gid://shopify/Customer/2` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-joined-segment.json)

## customer.left_segment

Confidence: documented · Schema: from Shopify docs (example)

Customer leaves a segment

Identified by: x-shopify-topic header · Object: `customers`

```json
{
  "shop_id": "gid://shopify/Shop/1",
  "customer_id": "gid://shopify/Customer/2",
  "segment_id": "gid://shopify/Segment/3"
}
```



| Key field | Type | Example |
|---|---|---|
| `customer_id` | string | `gid://shopify/Customer/2` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-left-segment.json)

## customer_payment_methods/create

Confidence: documented · Schema: from Shopify docs (example)

New customer payment method created

Identified by: x-shopify-topic header · Object: `customers`

```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": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-payment-methods-create.json)

| Key field | Type | Example |
|---|---|---|
| `customer_id` | integer | `82850125` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-payment-methods-create.json)

## customer_payment_methods/revoke

Confidence: documented · Schema: from Shopify docs (example)

Customer payment method revoked

Identified by: x-shopify-topic header · Object: `customers`

```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": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-payment-methods-revoke.json)

| Key field | Type | Example |
|---|---|---|
| `customer_id` | integer | `82850125` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-payment-methods-revoke.json)

## customer_payment_methods/update

Confidence: documented · Schema: from Shopify docs (example)

Customer payment method changes

Identified by: x-shopify-topic header · Object: `customers`

```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": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-payment-methods-update.json)

| Key field | Type | Example |
|---|---|---|
| `customer_id` | integer | `82850125` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-payment-methods-update.json)

## customer.tags_added

Confidence: documented · Schema: from Shopify docs (example)

Tags added to a customer

Identified by: x-shopify-topic header · Object: `customers`

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

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

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-tags-added.json)

## customer.tags_removed

Confidence: documented · Schema: from Shopify docs (example)

Tags removed from a customer

Identified by: x-shopify-topic header · Object: `customers`

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

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

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customer-tags-removed.json)

## customers/delete

Confidence: documented · Schema: from Shopify docs (example)

Customer is deleted

Identified by: x-shopify-topic header · Object: `customers`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-delete.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `706405506930370000` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-delete.json)

## customers/disable

Confidence: documented · Schema: from Shopify docs (example)

Customer account is disabled

Identified by: x-shopify-topic header · Object: `customers`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-disable.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `706405506930370000` |
| `state` | string | `disabled` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-disable.json)

## customers_email_marketing_consent/update

Confidence: documented · Schema: from Shopify docs (example)

Customer's email marketing consent changes

Identified by: x-shopify-topic header · Object: `customers`

```json
{
  "customer_id": 706405506930370000,
  "email_address": null,
  "email_marketing_consent": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-email-marketing-consent-update.json)

| Key field | Type | Example |
|---|---|---|
| `customer_id` | integer | `706405506930370000` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-email-marketing-consent-update.json)

## customers/enable

Confidence: documented · Schema: from Shopify docs (example)

Customer account is enabled

Identified by: x-shopify-topic header · Object: `customers`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-enable.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `706405506930370000` |
| `state` | string | `disabled` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-enable.json)

## customers_marketing_consent/update

Confidence: documented · Schema: from Shopify docs (example)

Customer's SMS marketing consent changes

Identified by: x-shopify-topic header · Object: `customers`

```json
{
  "id": 706405506930370000,
  "phone": null,
  "sms_marketing_consent": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-marketing-consent-update.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `706405506930370000` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-marketing-consent-update.json)

## customers/merge

Confidence: documented · Schema: from Shopify docs (example)

Two customers merged into one

Identified by: x-shopify-topic header · Object: `customers`

```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": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-merge.json)

| Key field | Type | Example |
|---|---|---|
| `status` | string | `failed` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-merge.json)

## customers/purchasing_summary

Confidence: documented · Schema: from Shopify docs (example)

Customer's sales history changes

Identified by: x-shopify-topic header · Object: `customers`

```json
{
  "customerId": "gid://shopify/Customer/1",
  "numberOfOrders": 1,
  "amountSpent": { … },
  "lastOrderId": "gid://shopify/Order/1",
  "occurredAt": "2005-05-05T05:00:00.000Z"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-purchasing-summary.json)

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-purchasing-summary.json)

## customers/data_request

Confidence: verified · Schema: from a captured delivery

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

Identified by: x-shopify-topic header · Object: `customers`

```json
{
  "shop_id": 954889,
  "shop_domain": "{shop}.myshopify.com",
  "customer": { … },
  "orders_requested": [ … ],
  "data_request": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-data-request.json)

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`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-data-request.json)

## customers/redact

Confidence: verified · Schema: from a captured delivery

Store owner asks you to delete a customer's data

Identified by: x-shopify-topic header · Object: `customers`

```json
{
  "shop_id": 954889,
  "shop_domain": "{shop}.myshopify.com",
  "customer": { … },
  "orders_to_redact": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-redact.json)

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`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-redact.json)

## customers_whats_app_marketing_consent/update

Confidence: documented · Schema: from Shopify docs (example)

Customer's WhatsApp marketing consent changes

Identified by: x-shopify-topic header · Object: `customers`

```json
{
  "customer_id": 706405506930370000,
  "phone_number": null,
  "whats_app_marketing_consent": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-whats-app-marketing-consent-update.json)

| Key field | Type | Example |
|---|---|---|
| `customer_id` | integer | `706405506930370000` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/customers-whats-app-marketing-consent-update.json)

## segments/create

Confidence: documented · Schema: from Shopify docs (example)

New segment created

Identified by: x-shopify-topic header · Object: `customers`

```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 field | Type | Example |
|---|---|---|
| `id` | integer | `1` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/segments-create.json)

## segments/delete

Confidence: documented · Schema: from Shopify docs (example)

Segment is deleted

Identified by: x-shopify-topic header · Object: `customers`

```json
{
  "id": 1
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `1` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/segments-delete.json)

## segments/update

Confidence: documented · Schema: from Shopify docs (example)

Segment details change

Identified by: x-shopify-topic header · Object: `customers`

```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 field | Type | Example |
|---|---|---|
| `id` | integer | `1` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/segments-update.json)

---

Not affiliated with Shopify. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/shopify.json) · [Report a correction](https://hookdeck.com/contact)
