Skip to main content

Choose a version:

Customer

Requires read_customers access scope.

Subscribe to field-level changes on the Customer GraphQL Admin API object. You can subscribe to created, deleted, and updated resources, as well as changes to specific fields.

Each topic corresponds to a commerce resource (for example, a customer) that can exist independently within its domain. Child entities that depend on a parent within the same domain don't have their own topic. Instead, changes to child entities trigger a delivery on the parent topic. Calculated fields, derived fields, auto-updated timestamps, and cross-domain fields aren't available as triggers.

A subscription can combine multiple triggers. Your custom query can include any data available in the GraphQL Admin API, including fields unrelated to the subscribed topic, so each delivery contains exactly what your app needs.

Anchor to Supported triggersSupported triggers

Field-level triggers for Customer subscriptions.

All triggers require the read_customers access scope, and those triggers that require additional scopes are documented where relevant. Deprecated triggers are listed last.

Subscriptions can be made up of multiple triggers. When a merchant action impacts multiple triggers, the deliveries share the same shopify-event-id header. Each individually updated field has a unique composite key in the shopify-webhook-id header. Use this value to differentiate duplicate deliveries.

Custom queries aren't limited to Customer. They can query the full GraphQL Admin API.

Anchor to list-of-topics-customer

customer

Fires when events involve the Customer object.

The "create" and "delete" actions are only relevant within the context of this parent topic. Use fields_changed to follow or replicate impacted data after a delete event. Define a custom query to retrieve specific fields from create events.

Collect details about changes to the object by subscribing to the trigger along with the "update" action, though it's recommended that you narrow your subscription to one of the other triggers below.

Variables: customerId

Anchor to list-of-topics-customer.addressesV2

customer.addressesV2

Fires when the addressesV2 field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The addressesV2 field represents the addresses associated with the customer.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.address1

customer.addressesV2.address1

Fires when the address1 field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The address1 field represents the first line of the address.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.address2

customer.addressesV2.address2

Fires when the address2 field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The address2 field represents the second line of the address.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.city

customer.addressesV2.city

Fires when the city field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The city field represents the name of the city, district, village, or town.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.company

customer.addressesV2.company

Fires when the company field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The company field represents the name of the customer's company or organization.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.countryCodeV2

customer.addressesV2.countryCodeV2

Fires when the countryCodeV2 field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The countryCodeV2 field represents the two-letter code for the country of the address.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.firstName

customer.addressesV2.firstName

Fires when the firstName field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The firstName field represents the first name of the customer.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.lastName

customer.addressesV2.lastName

Fires when the lastName field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The lastName field represents the last name of the customer.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.latitude

customer.addressesV2.latitude

Fires when the latitude field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The latitude field represents the latitude coordinate of the customer address.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.longitude

customer.addressesV2.longitude

Fires when the longitude field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The longitude field represents the longitude coordinate of the customer address.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.phone

customer.addressesV2.phone

Fires when the phone field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The phone field represents a unique phone number for the customer.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.provinceCode

customer.addressesV2.provinceCode

Fires when the provinceCode field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The provinceCode field represents the alphanumeric code for the region.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.addressesV2.zip

customer.addressesV2.zip

Fires when the zip field on the MailingAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The zip field represents the zip or postal code of the address.

Variables: addressesV2Id, customerId

Anchor to list-of-topics-customer.amountSpent

customer.amountSpent

Fires when the amountSpent field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The amountSpent field represents the total amount that the customer has spent on orders in their lifetime.

Variables: customerId

Anchor to list-of-topics-customer.dataSaleOptOut

customer.dataSaleOptOut

Fires when the dataSaleOptOut field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The dataSaleOptOut field indicates whether the customer has opted out of having their data sold.

Variables: customerId

Anchor to list-of-topics-customer.defaultAddress

customer.defaultAddress

Fires when the defaultAddress field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The defaultAddress field represents the default address associated with the customer.

Variables: customerId

Anchor to list-of-topics-customer.defaultEmailAddress

customer.defaultEmailAddress

Fires when the defaultEmailAddress field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The defaultEmailAddress field represents the customer's default email address.

Variables: customerId

Anchor to list-of-topics-customer.defaultEmailAddress.marketingOptInLevel

customer.defaultEmailAddress.marketingOptInLevel

Fires when the marketingOptInLevel field on the CustomerEmailAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The marketingOptInLevel field represents the marketing subscription opt-in level, as described by the M3AAWG best practices guidelines, received when the marketing consent was updated.

Variables: customerId

Anchor to list-of-topics-customer.defaultEmailAddress.marketingState

customer.defaultEmailAddress.marketingState

Fires when the marketingState field on the CustomerEmailAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The marketingState field indicates whether the customer has subscribed to email marketing.

Variables: customerId

Anchor to list-of-topics-customer.defaultEmailAddress.marketingUpdatedAt

customer.defaultEmailAddress.marketingUpdatedAt

Fires when the marketingUpdatedAt field on the CustomerEmailAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The marketingUpdatedAt field represents the date and time at which the marketing consent was updated.

Variables: customerId

Anchor to list-of-topics-customer.defaultEmailAddress.openTrackingLevel

customer.defaultEmailAddress.openTrackingLevel

Fires when the openTrackingLevel field on the CustomerEmailAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The openTrackingLevel field indicates whether the customer has opted in to having their opened emails tracked.

Variables: customerId

Anchor to list-of-topics-customer.defaultEmailAddress.sourceLocation

customer.defaultEmailAddress.sourceLocation

Fires when the sourceLocation field on the CustomerEmailAddress object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The sourceLocation field represents the location where the customer consented to receive marketing material by email.

Variables: customerId

Anchor to list-of-topics-customer.defaultPhoneNumber

customer.defaultPhoneNumber

Fires when the defaultPhoneNumber field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The defaultPhoneNumber field represents the customer's default phone number.

Variables: customerId

Anchor to list-of-topics-customer.defaultPhoneNumber.marketingOptInLevel

customer.defaultPhoneNumber.marketingOptInLevel

Fires when the marketingOptInLevel field on the CustomerPhoneNumber object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The marketingOptInLevel field represents the marketing subscription opt-in level, as described by the M3AAWG best practices guidelines, received when the marketing consent was updated.

Variables: customerId

Anchor to list-of-topics-customer.defaultPhoneNumber.marketingState

customer.defaultPhoneNumber.marketingState

Fires when the marketingState field on the CustomerPhoneNumber object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The marketingState field indicates whether the customer has subscribed to SMS marketing material.

Variables: customerId

Anchor to list-of-topics-customer.defaultPhoneNumber.marketingUpdatedAt

customer.defaultPhoneNumber.marketingUpdatedAt

Fires when the marketingUpdatedAt field on the CustomerPhoneNumber object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The marketingUpdatedAt field represents the date and time at which the marketing consent was updated.

Variables: customerId

Anchor to list-of-topics-customer.defaultPhoneNumber.sourceLocation

customer.defaultPhoneNumber.sourceLocation

Fires when the sourceLocation field on the CustomerPhoneNumber object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The sourceLocation field represents the location where the customer consented to receive marketing material by SMS.

Variables: customerId

Anchor to list-of-topics-customer.firstName

customer.firstName

Fires when the firstName field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The firstName field represents the customer's first name.

Variables: customerId

Anchor to list-of-topics-customer.image

customer.image

Fires when the image field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The image field represents the image associated with the customer.

Variables: customerId

Anchor to list-of-topics-customer.lastName

customer.lastName

Fires when the lastName field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The lastName field represents the customer's last name.

Variables: customerId

Anchor to list-of-topics-customer.lastOrder

customer.lastOrder

Fires when the lastOrder field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The lastOrder field represents the customer's last order.

Variables: customerId

Anchor to list-of-topics-customer.locale

customer.locale

Fires when the locale field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The locale field represents the customer's locale.

Variables: customerId

Anchor to list-of-topics-customer.multipassIdentifier

customer.multipassIdentifier

Fires when the multipassIdentifier field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The multipassIdentifier field represents a unique identifier for the customer that's used with Multipass login.

Variables: customerId

Anchor to list-of-topics-customer.note

customer.note

Fires when the note field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The note field represents a note about the customer.

Variables: customerId

Anchor to list-of-topics-customer.numberOfOrders

customer.numberOfOrders

Fires when the numberOfOrders field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The numberOfOrders field represents the number of orders that the customer has made at the store in their lifetime.

Variables: customerId

Anchor to list-of-topics-customer.productSubscriberStatus

customer.productSubscriberStatus

Fires when the productSubscriberStatus field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

Possible subscriber states of a customer defined by their subscription contracts.

Variables: customerId

Anchor to list-of-topics-customer.state

customer.state

Fires when the state field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The state field represents the state of the customer's account with the shop.

Variables: customerId

Anchor to list-of-topics-customer.tags

customer.tags

Fires when the tags field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The tags field represents a comma separated list of tags that have been added to the customer.

Variables: customerId

Anchor to list-of-topics-customer.taxExempt

customer.taxExempt

Fires when the taxExempt field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The taxExempt field indicates whether the customer is exempt from being charged taxes on their orders.

Variables: customerId

Anchor to list-of-topics-customer.taxExemptions

customer.taxExemptions

Fires when the taxExemptions field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The taxExemptions field represents the list of tax exemptions applied to the customer.

Variables: customerId

Anchor to list-of-topics-customer.verifiedEmail

customer.verifiedEmail

Fires when the verifiedEmail field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The verifiedEmail field indicates whether the customer has verified their email address.

Variables: customerId

Anchor to list-of-topics-customer.email

customer.email

Deprecated

Fires when the email field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The email field represents the customer's email address.

Variables: customerId

Anchor to list-of-topics-customer.phone

customer.phone

Deprecated

Fires when the phone field on the Customer object changes.

Subscribe to this trigger with the "update" action and include the field in a custom query to retrieve updated data from the payload. You can trace the field in subsequent requests using fields_changed.

The phone field represents the customer's phone number.

Variables: customerId

Subscribe via app configuration

[events]

api_version = "unstable"

[[events.subscription]]

handle = "customer_evt_ip735t"

topic = "Customer"

actions = ["create"]

triggers = ["customer"]

uri = "https://your-app.com/events"

query = """

query customer_details($customerId: ID!) {

customer(id: $customerId) {

id

displayName

email

state

}

}

"""

# Optional

query_filter = "customer.state:'ENABLED'"

Examples

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_ip735t"

topic = "Customer"
actions = ["create"]
triggers = ["customer"]

uri = "https://your-app.com/events"

query = """
query customer_details($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    state
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "create",
  "handle": "customer_evt_ip735t",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "state": "ENABLED"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456']"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: create
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_ip735t
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_2rvfmz"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        id
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_2rvfmz",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "id": "gid://shopify/MailingAddress/111"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_2rvfmz
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_yedttu"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.address1"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        address1
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_yedttu",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "address1": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.address1"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_yedttu
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_yedttt"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.address2"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        address2
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_yedttt",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "address2": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.address2"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_yedttt
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_zn61mq"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.city"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        city
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_zn61mq",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "city": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.city"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_zn61mq
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_fdl0zm"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.company"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        company
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_fdl0zm",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "company": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.company"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_fdl0zm
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_1h2i1yc"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.countryCodeV2"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        countryCodeV2
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_1h2i1yc",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "countryCodeV2": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.countryCodeV2"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_1h2i1yc
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_yrmb20"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.firstName"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        firstName
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_yrmb20",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "firstName": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.firstName"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_yrmb20
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_7zfjbc"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.lastName"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        lastName
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_7zfjbc",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "lastName": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.lastName"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_7zfjbc
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_cl7qt1"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.latitude"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        latitude
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_cl7qt1",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "latitude": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.latitude"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_cl7qt1
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_323vmu"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.longitude"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        longitude
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_323vmu",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "longitude": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.longitude"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_323vmu
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_142peex"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.phone"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        phone
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_142peex",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "phone": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.phone"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_142peex
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_unm6du"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.provinceCode"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        provinceCode
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_unm6du",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "provinceCode": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.provinceCode"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_unm6du
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_11o75om"

topic = "Customer"
actions = ["update"]
triggers = ["customer.addressesV2.zip"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    addressesV2(first: 10) {
      nodes {
        zip
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_11o75om",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "addressesV2": {
        "nodes": [
          {
            "zip": "…"
          }
        ]
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].addressesV2.zip"
  ],
  "query_variables": {
    "addressesV2Id": "gid://shopify/Resource/441",
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_11o75om
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_9tuzjz"

topic = "Customer"
actions = ["update"]
triggers = ["customer.amountSpent"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    amountSpent {
      __typename
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_9tuzjz",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "amountSpent": {
        "__typename": "MoneyV2"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].amountSpent"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_9tuzjz
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_uqnsn5"

topic = "Customer"
actions = ["update"]
triggers = ["customer.dataSaleOptOut"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    dataSaleOptOut
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_uqnsn5",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "dataSaleOptOut": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].dataSaleOptOut"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_uqnsn5
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_1sron02"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultAddress"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultAddress {
      id
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_1sron02",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultAddress": {
        "id": "gid://shopify/MailingAddress/111"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultAddress"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_1sron02
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_1hues5a"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultEmailAddress"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultEmailAddress {
      __typename
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_1hues5a",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultEmailAddress": {
        "__typename": "CustomerEmailAddress"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultEmailAddress"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_1hues5a
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_1mk19gu"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultEmailAddress.marketingOptInLevel"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultEmailAddress {
      marketingOptInLevel
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_1mk19gu",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultEmailAddress": {
        "marketingOptInLevel": "…"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultEmailAddress.marketingOptInLevel"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_1mk19gu
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_1ul4lr7"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultEmailAddress.marketingState"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultEmailAddress {
      marketingState
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_1ul4lr7",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultEmailAddress": {
        "marketingState": "…"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultEmailAddress.marketingState"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_1ul4lr7
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_p92kms"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultEmailAddress.marketingUpdatedAt"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultEmailAddress {
      marketingUpdatedAt
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_p92kms",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultEmailAddress": {
        "marketingUpdatedAt": "…"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultEmailAddress.marketingUpdatedAt"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_p92kms
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_1r9tot9"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultEmailAddress.openTrackingLevel"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultEmailAddress {
      openTrackingLevel
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_1r9tot9",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultEmailAddress": {
        "openTrackingLevel": "…"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultEmailAddress.openTrackingLevel"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_1r9tot9
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_47yu1c"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultEmailAddress.sourceLocation"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultEmailAddress {
      sourceLocation {
        id
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_47yu1c",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultEmailAddress": {
        "sourceLocation": {
          "id": "gid://shopify/Location/111"
        }
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultEmailAddress.sourceLocation"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_47yu1c
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_165a43f"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultPhoneNumber"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultPhoneNumber {
      __typename
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_165a43f",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultPhoneNumber": {
        "__typename": "CustomerPhoneNumber"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultPhoneNumber"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_165a43f
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_mcmxnv"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultPhoneNumber.marketingOptInLevel"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultPhoneNumber {
      marketingOptInLevel
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_mcmxnv",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultPhoneNumber": {
        "marketingOptInLevel": "…"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultPhoneNumber.marketingOptInLevel"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_mcmxnv
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_a1q3gm"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultPhoneNumber.marketingState"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultPhoneNumber {
      marketingState
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_a1q3gm",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultPhoneNumber": {
        "marketingState": "…"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultPhoneNumber.marketingState"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_a1q3gm
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_h975ox"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultPhoneNumber.marketingUpdatedAt"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultPhoneNumber {
      marketingUpdatedAt
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_h975ox",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultPhoneNumber": {
        "marketingUpdatedAt": "…"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultPhoneNumber.marketingUpdatedAt"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_h975ox
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_bs99md"

topic = "Customer"
actions = ["update"]
triggers = ["customer.defaultPhoneNumber.sourceLocation"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    defaultPhoneNumber {
      sourceLocation {
        id
      }
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_bs99md",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "defaultPhoneNumber": {
        "sourceLocation": {
          "id": "gid://shopify/Location/111"
        }
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].defaultPhoneNumber.sourceLocation"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_bs99md
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_18iljte"

topic = "Customer"
actions = ["update"]
triggers = ["customer.firstName"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    firstName
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_18iljte",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "firstName": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].firstName"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_18iljte
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_19z0jwo"

topic = "Customer"
actions = ["update"]
triggers = ["customer.image"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    image {
      id
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_19z0jwo",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "image": {
        "id": "gid://shopify/Image/111"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].image"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_19z0jwo
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_1dvs1sy"

topic = "Customer"
actions = ["update"]
triggers = ["customer.lastName"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    lastName
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_1dvs1sy",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "lastName": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].lastName"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_1dvs1sy
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_cfzlkb"

topic = "Customer"
actions = ["update"]
triggers = ["customer.lastOrder"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    lastOrder {
      id
    }
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_cfzlkb",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "lastOrder": {
        "id": "gid://shopify/Order/111"
      }
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].lastOrder"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_cfzlkb
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_mc31bb"

topic = "Customer"
actions = ["update"]
triggers = ["customer.locale"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    locale
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_mc31bb",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "locale": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].locale"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_mc31bb
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_12i8xqs"

topic = "Customer"
actions = ["update"]
triggers = ["customer.multipassIdentifier"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    multipassIdentifier
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_12i8xqs",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "multipassIdentifier": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].multipassIdentifier"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_12i8xqs
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_eausrj"

topic = "Customer"
actions = ["update"]
triggers = ["customer.note"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    note
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_eausrj",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "note": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].note"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_eausrj
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_5u8g9k"

topic = "Customer"
actions = ["update"]
triggers = ["customer.numberOfOrders"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    numberOfOrders
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_5u8g9k",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "numberOfOrders": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].numberOfOrders"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_5u8g9k
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_y0wll6"

topic = "Customer"
actions = ["update"]
triggers = ["customer.productSubscriberStatus"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    productSubscriberStatus
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_y0wll6",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "productSubscriberStatus": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].productSubscriberStatus"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_y0wll6
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_1abbgm0"

topic = "Customer"
actions = ["update"]
triggers = ["customer.state"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    state
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_1abbgm0",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "state": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].state"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_1abbgm0
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_ebhkoe"

topic = "Customer"
actions = ["update"]
triggers = ["customer.tags"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    tags
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_ebhkoe",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "tags": [
        "…"
      ]
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].tags"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_ebhkoe
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_eyo8gj"

topic = "Customer"
actions = ["update"]
triggers = ["customer.taxExempt"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    taxExempt
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_eyo8gj",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "taxExempt": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].taxExempt"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_eyo8gj
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_nwqj3c"

topic = "Customer"
actions = ["update"]
triggers = ["customer.taxExemptions"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    taxExemptions
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_nwqj3c",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "taxExemptions": [
        "…"
      ]
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].taxExemptions"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_nwqj3c
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_fqbklh"

topic = "Customer"
actions = ["update"]
triggers = ["customer.verifiedEmail"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    verifiedEmail
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_fqbklh",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "verifiedEmail": "customer@example.com"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].verifiedEmail"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_fqbklh
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_1a1o2df"

topic = "Customer"
actions = ["update"]
triggers = ["customer.email"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_1a1o2df",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].email"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_1a1o2df
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Subscribe via app configuration

shopify.app.toml

[events]
api_version = "unstable"

[[events.subscription]]
handle = "customer_evt_1af2a6r"

topic = "Customer"
actions = ["update"]
triggers = ["customer.phone"]

uri = "https://your-app.com/events"

query = """
query customer_event_payload($customerId: ID!) {
  customer(id: $customerId) {
    id
    displayName
    email
    phone
  }
}
"""

# Optional
query_filter = "customer.state:'ENABLED'"

Payload

{
  "topic": "Customer",
  "action": "update",
  "handle": "customer_evt_1af2a6r",
  "data": {
    "customer": {
      "id": "gid://shopify/Customer/456",
      "displayName": "Example customer",
      "email": "customer@example.com",
      "phone": "…"
    }
  },
  "fields_changed": [
    "customer[id: 'gid://shopify/Customer/456'].phone"
  ],
  "query_variables": {
    "customerId": "gid://shopify/Customer/456"
  }
}

Headers

shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: customer_evt_1af2a6r
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/Customer/456
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: Customer
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba

Was this page helpful?