Company
read_companies access scope.read_companies access scope.:Subscribe to field-level changes on the Company GraphQL Admin API object. You can subscribe to create, delete, and update events, as well as changes to specific fields.
Each topic 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
Anchor to Supported triggersSupported triggers
Field-level triggers 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. They can query the full GraphQL Admin API.
Anchor to list-of-topics-company.*company .*
Fires when events involve the Company object.
The "create" and "delete" actions are only relevant within the context of this parent topic. Use 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:
Anchor to list-of-topics-company.contactRolescompany .contactRoles
Fires when the field on the 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 .
The field represents the list of roles for the company contacts.
Variables: ,
Anchor to list-of-topics-company.contacts.*company .contacts .*
Fires when the contacts field on the 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 .
The contacts field represents the list of contacts in the company.
Variables: ,
Anchor to list-of-topics-company.contacts.localecompany .contacts .locale
Fires when the locale field on the 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 .
The locale field represents the company contact's locale (language).
Variables: ,
Anchor to list-of-topics-company.contacts.roleAssignmentscompany .contacts .roleAssignments
Fires when the field on the 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 .
The field represents the list of roles assigned to this company contact.
Variables: , ,
Anchor to list-of-topics-company.contacts.titlecompany .contacts .title
Fires when the title field on the 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 .
The title field represents the company contact's job title.
Variables: ,
Anchor to list-of-topics-company.externalIdcompany .externalId
Fires when the field on the 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 .
The field represents a unique externally-supplied ID for the company.
Variables:
Anchor to list-of-topics-company.locations.*company .locations .*
Fires when the locations field on the 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 .
The locations field represents the list of locations in the company.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.*company .locations .billingAddress .*
Fires when the field on the object changes.
is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under , 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 .
The field represents the address used as billing address for the location.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.address1company .locations .billingAddress .address1
Fires when the address1 field on the 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 .
The address1 field represents the first line of the address.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.address2company .locations .billingAddress .address2
Fires when the address2 field on the 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 .
The address2 field represents the second line of the address.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.citycompany .locations .billingAddress .city
Fires when the city field on the 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 .
The city field represents the name of the city, district, village, or town.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.countrycompany .locations .billingAddress .country
Fires when the country field on the 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 .
The country field represents the name of the country.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.countryCodecompany .locations .billingAddress .countryCode
Fires when the field on the 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 .
The field represents the two-letter code for the country of the address.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.firstNamecompany .locations .billingAddress .firstName
Anchor to list-of-topics-company.locations.billingAddress.lastNamecompany .locations .billingAddress .lastName
Anchor to list-of-topics-company.locations.billingAddress.phonecompany .locations .billingAddress .phone
Fires when the phone field on the 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 .
The phone field represents a unique phone number for the customer.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.provincecompany .locations .billingAddress .province
Fires when the province field on the 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 .
The province field represents the region of the address, such as the province, state, or district.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.recipientcompany .locations .billingAddress .recipient
Fires when the recipient field on the 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 .
The recipient field represents the identity of the recipient e.g.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.zipcompany .locations .billingAddress .zip
Fires when the zip field on the 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 .
The zip field represents the zip or postal code of the address.
Variables: ,
Anchor to list-of-topics-company.locations.billingAddress.zoneCodecompany .locations .billingAddress .zoneCode
Fires when the field on the 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 .
The field represents the alphanumeric code for the region.
Variables: ,
Anchor to list-of-topics-company.locations.buyerExperienceConfiguration.*company .locations .buyerExperienceConfiguration .*
Fires when the field on the object changes.
is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under , 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 .
The field represents the configuration for the buyer's B2B checkout.
Variables: ,
Anchor to list-of-topics-company.locations.buyerExperienceConfiguration.checkoutToDraftcompany .locations .buyerExperienceConfiguration .checkoutToDraft
Fires when the field on the 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 .
The field indicates whether to checkout to draft order for merchant review.
Variables: ,
Anchor to list-of-topics-company.locations.buyerExperienceConfiguration.depositcompany .locations .buyerExperienceConfiguration .deposit
Fires when the deposit field on the 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 .
The deposit field represents the portion required to be paid at checkout.
Variables: ,
Anchor to list-of-topics-company.locations.buyerExperienceConfiguration.editableShippingAddresscompany .locations .buyerExperienceConfiguration .editableShippingAddress
Fires when the field on the 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 .
The field indicates whether to allow customers to use editable shipping addresses.
Variables: ,
Anchor to list-of-topics-company.locations.buyerExperienceConfiguration.paymentTermsTemplatecompany .locations .buyerExperienceConfiguration .paymentTermsTemplate
Anchor to list-of-topics-company.locations.currencycompany .locations .currency
Fires when the currency field on the 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 .
The currency field represents the location's currency based on the shipping address.
Variables: ,
Anchor to list-of-topics-company.locations.externalIdcompany .locations .externalId
Fires when the field on the 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 .
The field represents a unique externally-supplied ID for the company location.
Variables: ,
Anchor to list-of-topics-company.locations.localecompany .locations .locale
Fires when the locale field on the 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 .
The locale field represents the preferred locale of the company location.
Variables: ,
Anchor to list-of-topics-company.locations.namecompany .locations .name
Fires when the name field on the 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 .
The name field represents the name of the company location.
Variables: ,
Anchor to list-of-topics-company.locations.notecompany .locations .note
Fires when the note field on the 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 .
The note field represents a note about the company location.
Variables: ,
Anchor to list-of-topics-company.locations.phonecompany .locations .phone
Fires when the phone field on the 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 .
The phone field represents the phone number of the company location.
Variables: ,
Anchor to list-of-topics-company.locations.roleAssignmentscompany .locations .roleAssignments
Fires when the field on the 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 .
The field represents the list of roles assigned to the company location.
Variables: , ,
Anchor to list-of-topics-company.locations.shippingAddress.*company .locations .shippingAddress .*
Fires when the field on the object changes.
is a parent trigger. Subscribing with the "update" action receives events for all supported triggers under , 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 .
The field represents the address used as shipping address for the location.
Variables: ,
Anchor to list-of-topics-company.locations.shippingAddress.address1company .locations .shippingAddress .address1
Fires when the address1 field on the 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 .
The address1 field represents the first line of the address.
Variables: ,
Anchor to list-of-topics-company.locations.shippingAddress.address2company .locations .shippingAddress .address2
Fires when the address2 field on the 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 .
The address2 field represents the second line of the address.
Variables: ,
Anchor to list-of-topics-company.locations.shippingAddress.citycompany .locations .shippingAddress .city
Fires when the city field on the 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 .
The city field represents the name of the city, district, village, or town.
Variables: ,
Anchor to list-of-topics-company.locations.shippingAddress.countrycompany .locations .shippingAddress .country
Fires when the country field on the 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 .
The country field represents the name of the country.
Variables: ,
Anchor to list-of-topics-company.locations.shippingAddress.countryCodecompany .locations .shippingAddress .countryCode
Fires when the field on the 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 .
The field represents the two-letter code for the country of the address.
Variables: ,
Anchor to list-of-topics-company.locations.shippingAddress.firstNamecompany .locations .shippingAddress .firstName
Anchor to list-of-topics-company.locations.shippingAddress.lastNamecompany .locations .shippingAddress .lastName
Anchor to list-of-topics-company.locations.shippingAddress.phonecompany .locations .shippingAddress .phone
Fires when the phone field on the 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 .
The phone field represents a unique phone number for the customer.
Variables: ,
Anchor to list-of-topics-company.locations.shippingAddress.provincecompany .locations .shippingAddress .province
Fires when the province field on the 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 .
The province field represents the region of the address, such as the province, state, or district.
Variables: ,
Anchor to list-of-topics-company.locations.shippingAddress.recipientcompany .locations .shippingAddress .recipient
Fires when the recipient field on the 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 .
The recipient field represents the identity of the recipient e.g.
Variables: ,
Anchor to list-of-topics-company.locations.shippingAddress.zipcompany .locations .shippingAddress .zip
Fires when the zip field on the 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 .
The zip field represents the zip or postal code of the address.
Variables: ,
Anchor to list-of-topics-company.locations.shippingAddress.zoneCodecompany .locations .shippingAddress .zoneCode
Fires when the field on the 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 .
The field represents the alphanumeric code for the region.
Variables: ,
Anchor to list-of-topics-company.mainContactcompany .mainContact
Fires when the field on the 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 .
The field represents the main contact for the company.
Variables:
Anchor to list-of-topics-company.metafield(namespace: String!, key: String!).*company .metafield(namespace: String!, key: String!) .*
Fires when the metafield field on the 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 .
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: , ,
Anchor to list-of-topics-company.metafield(namespace: String!).*company .metafield(namespace: String!) .*
Fires when the metafield field on the 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 .
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: , ,
Anchor to list-of-topics-company.metafield(namespace: String!, key: String!).valuecompany .metafield(namespace: String!, key: String!) .value
Fires when the value field on the 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 .
The value field represents the data stored in the metafield.
Variables: , ,
Anchor to list-of-topics-company.metafield(namespace: String!).valuecompany .metafield(namespace: String!) .value
Fires when the value field on the 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 .
This subscription omits the optional argument metafield.key.
The value field represents the data stored in the metafield.
Variables: , ,
Anchor to list-of-topics-company.namecompany .name
Fires when the name field on the 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 .
The name field represents the name of the company.
Variables:
Anchor to list-of-topics-company.notecompany .note
Fires when the note field on the 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 .
The note field represents a note about the company.
Variables: