---
title: Company
description: Subscribe to field-level changes on the Company GraphQL Admin API object.
api_version: unstable
source_url:
  html: 'https://shopify.dev/docs/api/events/latest/company'
  md: 'https://shopify.dev/docs/api/events/latest/company.md'
api_name: events
---

# Company

**Requires `read_companies` access scope.:**

Subscribe to field-level changes on the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) GraphQL Admin API object. You can subscribe to create, delete, and update events, as well as changes to specific fields.

Each [topic](https://shopify.dev/docs/api/events/latest#configuration) corresponds to a commerce resource 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.

## shopify.app.toml

```toml
[events]
api_version = "unstable"


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


topic = "Company"
actions = ["update"]
triggers = ["company.contactRoles"]


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


query = """
query company_event_payload($companyId: ID!) {
  company(id: $companyId) {
    id
    name
    contactRoles(first: 10) {
      nodes {
        id
      }
    }
  }
}
"""
```

***

## Supported triggers

Field-level [triggers](https://shopify.dev/docs/api/events/latest#configuration) for `Company` subscriptions.

All triggers require the `read_companies` access scope. Those triggers that require additional scopes are documented where relevant. Deprecated triggers are listed last.

Subscriptions can include multiple triggers. Use the `shopify-webhook-id` header for deduplication when handling duplicate deliveries.

Custom queries aren't limited to [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company). They can query the full GraphQL Admin API.

### company​.\*

Fires when events involve the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) 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.

`company.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `company`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

**Variables:** `companyId`

### company​.contactRoles

Fires when the [`contactRoles`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.contactRoles) field on the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) 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 `contactRoles` field represents the list of roles for the company contacts.

**Variables:** `companyId`, `contactRolesId`

### company​.contacts​.\*

Fires when the [`contacts`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.contacts) field on the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) object changes.

`company.contacts.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `company.contacts`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

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 `contacts` field represents the list of contacts in the company.

**Variables:** `companyId`, `contactsId`

### company​.contacts​.locale

Fires when the [`locale`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyContact#field-CompanyContact.fields.locale) field on the [`CompanyContact`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyContact) 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 company contact's locale (language).

**Variables:** `companyId`, `contactsId`

### company​.contacts​.roleAssignments

Fires when the [`roleAssignments`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyContact#field-CompanyContact.fields.roleAssignments) field on the [`CompanyContact`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyContact) 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 `roleAssignments` field represents the list of roles assigned to this company contact.

**Variables:** `companyId`, `contactsId`, `roleAssignmentsId`

### company​.contacts​.title

Fires when the [`title`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyContact#field-CompanyContact.fields.title) field on the [`CompanyContact`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyContact) 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 `title` field represents the company contact's job title.

**Variables:** `companyId`, `contactsId`

### company​.externalId

Fires when the [`externalId`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.externalId) field on the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) 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 `externalId` field represents a unique externally-supplied ID for the company.

**Variables:** `companyId`

### company​.locations​.\*

Fires when the [`locations`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.locations) field on the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) object changes.

`company.locations.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `company.locations`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

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 `locations` field represents the list of locations in the company.

**Variables:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.\*

Fires when the [`billingAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation#field-CompanyLocation.fields.billingAddress) field on the [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation) object changes.

`company.locations.billingAddress.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `company.locations.billingAddress`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

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 `billingAddress` field represents the address used as billing address for the location.

**Variables:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.address1

Fires when the [`address1`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.address1) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.address2

Fires when the [`address2`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.address2) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.city

Fires when the [`city`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.city) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.country

Fires when the [`country`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.country) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 `country` field represents the name of the country.

**Variables:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.countryCode

Fires when the [`countryCode`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.countryCode) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 `countryCode` field represents the two-letter code for the country of the address.

**Variables:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.firstName

Fires when the [`firstName`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.firstName) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 recipient.

**Variables:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.lastName

Fires when the [`lastName`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.lastName) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 recipient.

**Variables:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.phone

Fires when the [`phone`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.phone) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.province

Fires when the [`province`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.province) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 `province` field represents the region of the address, such as the province, state, or district.

**Variables:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.recipient

Fires when the [`recipient`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.recipient) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 `recipient` field represents the identity of the recipient e.g.

**Variables:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.zip

Fires when the [`zip`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.zip) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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:** `companyId`, `locationsId`

### company​.locations​.billingAddress​.zoneCode

Fires when the [`zoneCode`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.zoneCode) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 `zoneCode` field represents the alphanumeric code for the region.

**Variables:** `companyId`, `locationsId`

### company​.locations​.buyerExperienceConfiguration​.\*

Fires when the [`buyerExperienceConfiguration`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation#field-CompanyLocation.fields.buyerExperienceConfiguration) field on the [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation) object changes.

`company.locations.buyerExperienceConfiguration.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `company.locations.buyerExperienceConfiguration`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

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 `buyerExperienceConfiguration` field represents the configuration for the buyer's B2B checkout.

**Variables:** `companyId`, `locationsId`

### company​.locations​.buyerExperienceConfiguration​.checkoutToDraft

Fires when the [`checkoutToDraft`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/BuyerExperienceConfiguration#field-BuyerExperienceConfiguration.fields.checkoutToDraft) field on the [`BuyerExperienceConfiguration`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/BuyerExperienceConfiguration) 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 `checkoutToDraft` field indicates whether to checkout to draft order for merchant review.

**Variables:** `companyId`, `locationsId`

### company​.locations​.buyerExperienceConfiguration​.deposit

Fires when the [`deposit`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/BuyerExperienceConfiguration#field-BuyerExperienceConfiguration.fields.deposit) field on the [`BuyerExperienceConfiguration`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/BuyerExperienceConfiguration) 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 `deposit` field represents the portion required to be paid at checkout.

**Variables:** `companyId`, `locationsId`

### company​.locations​.buyerExperienceConfiguration​.editableShippingAddress

Fires when the [`editableShippingAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/BuyerExperienceConfiguration#field-BuyerExperienceConfiguration.fields.editableShippingAddress) field on the [`BuyerExperienceConfiguration`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/BuyerExperienceConfiguration) 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 `editableShippingAddress` field indicates whether to allow customers to use editable shipping addresses.

**Variables:** `companyId`, `locationsId`

### company​.locations​.buyerExperienceConfiguration​.paymentTermsTemplate

Fires when the [`paymentTermsTemplate`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/BuyerExperienceConfiguration#field-BuyerExperienceConfiguration.fields.paymentTermsTemplate) field on the [`BuyerExperienceConfiguration`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/BuyerExperienceConfiguration) 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`.

Represents the merchant configured payment terms.

**Variables:** `companyId`, `locationsId`

### company​.locations​.currency

Fires when the [`currency`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation#field-CompanyLocation.fields.currency) field on the [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation) 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 `currency` field represents the location's currency based on the shipping address.

**Variables:** `companyId`, `locationsId`

### company​.locations​.externalId

Fires when the [`externalId`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation#field-CompanyLocation.fields.externalId) field on the [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation) 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 `externalId` field represents a unique externally-supplied ID for the company location.

**Variables:** `companyId`, `locationsId`

### company​.locations​.locale

Fires when the [`locale`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation#field-CompanyLocation.fields.locale) field on the [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation) 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 preferred locale of the company location.

**Variables:** `companyId`, `locationsId`

### company​.locations​.name

Fires when the [`name`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation#field-CompanyLocation.fields.name) field on the [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation) 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 `name` field represents the name of the company location.

**Variables:** `companyId`, `locationsId`

### company​.locations​.note

Fires when the [`note`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation#field-CompanyLocation.fields.note) field on the [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation) 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 company location.

**Variables:** `companyId`, `locationsId`

### company​.locations​.phone

Fires when the [`phone`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation#field-CompanyLocation.fields.phone) field on the [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation) 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 phone number of the company location.

**Variables:** `companyId`, `locationsId`

### company​.locations​.roleAssignments

Fires when the [`roleAssignments`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation#field-CompanyLocation.fields.roleAssignments) field on the [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation) 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 `roleAssignments` field represents the list of roles assigned to the company location.

**Variables:** `companyId`, `locationsId`, `roleAssignmentsId`

### company​.locations​.shippingAddress​.\*

Fires when the [`shippingAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation#field-CompanyLocation.fields.shippingAddress) field on the [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocation) object changes.

`company.locations.shippingAddress.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `company.locations.shippingAddress`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

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 `shippingAddress` field represents the address used as shipping address for the location.

**Variables:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.address1

Fires when the [`address1`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.address1) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.address2

Fires when the [`address2`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.address2) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.city

Fires when the [`city`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.city) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.country

Fires when the [`country`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.country) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 `country` field represents the name of the country.

**Variables:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.countryCode

Fires when the [`countryCode`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.countryCode) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 `countryCode` field represents the two-letter code for the country of the address.

**Variables:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.firstName

Fires when the [`firstName`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.firstName) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 recipient.

**Variables:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.lastName

Fires when the [`lastName`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.lastName) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 recipient.

**Variables:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.phone

Fires when the [`phone`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.phone) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.province

Fires when the [`province`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.province) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 `province` field represents the region of the address, such as the province, state, or district.

**Variables:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.recipient

Fires when the [`recipient`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.recipient) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 `recipient` field represents the identity of the recipient e.g.

**Variables:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.zip

Fires when the [`zip`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.zip) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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:** `companyId`, `locationsId`

### company​.locations​.shippingAddress​.zoneCode

Fires when the [`zoneCode`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress#field-CompanyAddress.fields.zoneCode) field on the [`CompanyAddress`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyAddress) 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 `zoneCode` field represents the alphanumeric code for the region.

**Variables:** `companyId`, `locationsId`

### company​.mainContact

Fires when the [`mainContact`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.mainContact) field on the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) 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 `mainContact` field represents the main contact for the company.

**Variables:** `companyId`

### company​.metafield(namespace: String!, key: String!)​.\*

Fires when the [`metafield`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.metafield) field on the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) object changes.

`company.metafield(namespace: String!, key: String!).*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `company.metafield(namespace: String!, key: String!)`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

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 `metafield` field represents a custom field, including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

**Variables:** `companyId`, `metafieldKey`, `metafieldNamespace`

### company​.metafield(namespace: String!)​.\*

Fires when the [`metafield`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.metafield) field on the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) object changes.

`company.metafield(namespace: String!).*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `company.metafield(namespace: String!)`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

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

This subscription omits the optional argument `metafield.key`.

The `metafield` field represents a custom field, including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

**Variables:** `companyId`, `metafieldKey`, `metafieldNamespace`

### company​.metafield(namespace: String!, key: String!)​.value

Fires when the [`value`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield#field-Metafield.fields.value) field on the [`Metafield`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield) 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 `value` field represents the data stored in the metafield.

**Variables:** `companyId`, `metafieldKey`, `metafieldNamespace`

### company​.metafield(namespace: String!)​.value

Fires when the [`value`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield#field-Metafield.fields.value) field on the [`Metafield`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield) 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`.

This subscription omits the optional argument `metafield.key`.

The `value` field represents the data stored in the metafield.

**Variables:** `companyId`, `metafieldKey`, `metafieldNamespace`

### company​.name

Fires when the [`name`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.name) field on the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) 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 `name` field represents the name of the company.

**Variables:** `companyId`

### company​.note

Fires when the [`note`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.note) field on the [`Company`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company) 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 company.

**Variables:** `companyId`

### Examples

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["create","update","delete"]
  triggers = ["company.*"]

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

  query = """
  query company_details($companyId: ID!) {
    company(id: $companyId) {
      id
      name
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Company",
    "action": "create",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company"
      }
    },
    "fields_changed": {
      "added": [
        "company[id: 'gid://shopify/Company/8115683391809']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809"
    }
  }
  ```

  ##### Payload (updated)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].contacts[id: 'gid://shopify/CompanyContact/1449457816174'].locale"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Company",
    "action": "delete",
    "handle": "company-event",
    "data": {
      "company": null
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "company[id: 'gid://shopify/Company/8115683391809']"
      ]
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update # or create, delete
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.contactRoles"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      contactRoles(first: 10) {
        nodes {
          id
        }
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "contactRoles": {
          "nodes": [
            {
              "id": "gid://shopify/CompanyContactRole/2413751731114"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [
        "company[id: 'gid://shopify/Company/8115683391809'].contactRoles[id: 'gid://shopify/CompanyContactRole/2413751731114']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "contactRolesId": "gid://shopify/CompanyContactRole/2413751731114"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "contactRoles": {
          "nodes": [
            {
              "id": "gid://shopify/CompanyContactRole/111"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "company[id: 'gid://shopify/Company/8115683391809'].contactRoles[id: 'gid://shopify/CompanyContactRole/2413751731114']"
      ]
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "contactRolesId": "gid://shopify/CompanyContactRole/2413751731114"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.contacts.*"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      contacts(first: 10) {
        nodes {
          id
        }
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "contacts": {
          "nodes": [
            {
              "id": "gid://shopify/CompanyContact/1449457816174"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [
        "company[id: 'gid://shopify/Company/8115683391809'].contacts[id: 'gid://shopify/CompanyContact/1449457816174']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "contactsId": "gid://shopify/CompanyContact/1449457816174"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "contacts": {
          "nodes": [
            {
              "id": "gid://shopify/CompanyContact/111"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "company[id: 'gid://shopify/Company/8115683391809'].contacts[id: 'gid://shopify/CompanyContact/1449457816174']"
      ]
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "contactsId": "gid://shopify/CompanyContact/1449457816174"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.contacts.locale"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      contacts(first: 10) {
        nodes {
          locale
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "contacts": {
          "nodes": [
            {
              "locale": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].contacts[id: 'gid://shopify/CompanyContact/1449457816174'].locale"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "contactsId": "gid://shopify/CompanyContact/1449457816174"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.contacts.roleAssignments"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      contacts(first: 10) {
        nodes {
          roleAssignments(first: 10) {
            nodes {
              id
            }
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "contacts": {
          "nodes": [
            {
              "roleAssignments": {
                "nodes": [
                  {
                    "id": "gid://shopify/CompanyContactRoleAssignment/4038748265160"
                  }
                ]
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [
        "company[id: 'gid://shopify/Company/8115683391809'].contacts[id: 'gid://shopify/CompanyContact/1449457816174'].roleAssignments[id: 'gid://shopify/CompanyContactRoleAssignment/4038748265160']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "contactsId": "gid://shopify/CompanyContact/1449457816174",
      "roleAssignmentsId": "gid://shopify/CompanyContactRoleAssignment/4038748265160"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "contacts": {
          "nodes": [
            {
              "roleAssignments": {
                "nodes": [
                  {
                    "id": "gid://shopify/CompanyContactRoleAssignment/111"
                  }
                ]
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "company[id: 'gid://shopify/Company/8115683391809'].contacts[id: 'gid://shopify/CompanyContact/1449457816174'].roleAssignments[id: 'gid://shopify/CompanyContactRoleAssignment/4038748265160']"
      ]
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "contactsId": "gid://shopify/CompanyContact/1449457816174",
      "roleAssignmentsId": "gid://shopify/CompanyContactRoleAssignment/4038748265160"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.contacts.title"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      contacts(first: 10) {
        nodes {
          title
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "contacts": {
          "nodes": [
            {
              "title": "Example product"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].contacts[id: 'gid://shopify/CompanyContact/1449457816174'].title"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "contactsId": "gid://shopify/CompanyContact/1449457816174"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.externalId"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      externalId
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "externalId": "…"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].externalId"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.*"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          id
        }
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "id": "gid://shopify/CompanyLocation/3099092649870"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "id": "gid://shopify/CompanyLocation/111"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870']"
      ]
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.*"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            id
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "id": "gid://shopify/CompanyAddress/111"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.address1"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            address1
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "address1": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.address1"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.address2"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            address2
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "address2": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.address2"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.city"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            city
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "city": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.city"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.country"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            country
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "country": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.country"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.countryCode"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            countryCode
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "countryCode": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.countryCode"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.firstName"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            firstName
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "firstName": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.firstName"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.lastName"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            lastName
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "lastName": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.lastName"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.phone"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            phone
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "phone": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.phone"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.province"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            province
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "province": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.province"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.recipient"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            recipient
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "recipient": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.recipient"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.zip"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            zip
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "zip": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.zip"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.billingAddress.zoneCode"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          billingAddress {
            zoneCode
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "billingAddress": {
                "zoneCode": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].billingAddress.zoneCode"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.buyerExperienceConfiguration.*"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          buyerExperienceConfiguration {
            __typename
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "buyerExperienceConfiguration": {
                "__typename": "BuyerExperienceConfiguration"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].buyerExperienceConfiguration"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.buyerExperienceConfiguration.checkoutToDraft"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          buyerExperienceConfiguration {
            checkoutToDraft
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "buyerExperienceConfiguration": {
                "checkoutToDraft": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].buyerExperienceConfiguration.checkoutToDraft"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.buyerExperienceConfiguration.deposit"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          buyerExperienceConfiguration {
            deposit {
              __typename
            }
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "buyerExperienceConfiguration": {
                "deposit": {
                  "__typename": "DepositPercentage"
                }
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].buyerExperienceConfiguration.deposit"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.buyerExperienceConfiguration.editableShippingAddress"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          buyerExperienceConfiguration {
            editableShippingAddress
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "buyerExperienceConfiguration": {
                "editableShippingAddress": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].buyerExperienceConfiguration.editableShippingAddress"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.buyerExperienceConfiguration.paymentTermsTemplate"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          buyerExperienceConfiguration {
            paymentTermsTemplate {
              id
            }
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "buyerExperienceConfiguration": {
                "paymentTermsTemplate": {
                  "id": "gid://shopify/PaymentTermsTemplate/111"
                }
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].buyerExperienceConfiguration.paymentTermsTemplate"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.currency"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          currency
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "currency": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].currency"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.externalId"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          externalId
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "externalId": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].externalId"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.locale"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          locale
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "locale": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].locale"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.name"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          name
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "name": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].name"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.note"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          note
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "note": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].note"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.phone"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          phone
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "phone": "…"
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].phone"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.roleAssignments"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          roleAssignments(first: 10) {
            nodes {
              id
            }
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "roleAssignments": {
                "nodes": [
                  {
                    "id": "gid://shopify/CompanyContactRoleAssignment/4038748265160"
                  }
                ]
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].roleAssignments[id: 'gid://shopify/CompanyContactRoleAssignment/4038748265160']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870",
      "roleAssignmentsId": "gid://shopify/CompanyContactRoleAssignment/4038748265160"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "roleAssignments": {
                "nodes": [
                  {
                    "id": "gid://shopify/CompanyContactRoleAssignment/111"
                  }
                ]
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].roleAssignments[id: 'gid://shopify/CompanyContactRoleAssignment/4038748265160']"
      ]
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870",
      "roleAssignmentsId": "gid://shopify/CompanyContactRoleAssignment/4038748265160"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.*"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            id
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "id": "gid://shopify/CompanyAddress/111"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.address1"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            address1
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "address1": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.address1"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.address2"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            address2
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "address2": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.address2"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.city"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            city
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "city": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.city"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.country"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            country
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "country": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.country"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.countryCode"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            countryCode
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "countryCode": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.countryCode"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.firstName"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            firstName
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "firstName": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.firstName"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.lastName"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            lastName
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "lastName": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.lastName"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.phone"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            phone
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "phone": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.phone"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.province"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            province
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "province": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.province"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.recipient"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            recipient
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "recipient": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.recipient"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.zip"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            zip
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "zip": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.zip"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.locations.shippingAddress.zoneCode"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      locations(first: 10) {
        nodes {
          shippingAddress {
            zoneCode
          }
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "locations": {
          "nodes": [
            {
              "shippingAddress": {
                "zoneCode": "…"
              }
            }
          ]
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].locations[id: 'gid://shopify/CompanyLocation/3099092649870'].shippingAddress.zoneCode"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "locationsId": "gid://shopify/CompanyLocation/3099092649870"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.mainContact"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      mainContact {
        id
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "mainContact": {
          "id": "gid://shopify/CompanyContact/111"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].mainContact"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.metafield(namespace: 'custom', key: 'rating').*"]

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

  query = """
  query company_event_payload($companyId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
    company(id: $companyId) {
      id
      name
      metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
        namespace
        key
        value
        type
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [
        "company[id: 'gid://shopify/Company/8115683391809'].metafield[namespace: 'custom', key: 'rating']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "company[id: 'gid://shopify/Company/8115683391809'].metafield[namespace: 'custom', key: 'rating']"
      ]
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.metafield(namespace: 'custom').*"]

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

  query = """
  query company_event_payload($companyId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
    company(id: $companyId) {
      id
      name
      metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
        namespace
        key
        value
        type
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [
        "company[id: 'gid://shopify/Company/8115683391809'].metafield[namespace: 'custom', key: 'rating']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "company[id: 'gid://shopify/Company/8115683391809'].metafield[namespace: 'custom', key: 'rating']"
      ]
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.metafield(namespace: 'custom', key: 'rating').value"]

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

  query = """
  query company_event_payload($companyId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
    company(id: $companyId) {
      id
      name
      metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
        namespace
        key
        value
        type
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].metafield[namespace: 'custom', key: 'rating'].value"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.metafield(namespace: 'custom').value"]

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

  query = """
  query company_event_payload($companyId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
    company(id: $companyId) {
      id
      name
      metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
        namespace
        key
        value
        type
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].metafield[namespace: 'custom', key: 'rating'].value"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.name"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].name"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "company-event"

  topic = "Company"
  actions = ["update"]
  triggers = ["company.note"]

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

  query = """
  query company_event_payload($companyId: ID!) {
    company(id: $companyId) {
      id
      name
      note
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Company",
    "action": "update",
    "handle": "company-event",
    "data": {
      "company": {
        "id": "gid://shopify/Company/8115683391809",
        "name": "Example company",
        "note": "…"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "company[id: 'gid://shopify/Company/8115683391809'].note"
      ],
      "removed": []
    },
    "query_variables": {
      "companyId": "gid://shopify/Company/8115683391809"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-handle: company-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Company
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

***