---
title: MetaobjectDefinition
description: >-
Subscribe to field-level changes on the MetaobjectDefinition GraphQL Admin API
object.
api_version: unstable
source_url:
html: 'https://shopify.dev/docs/api/events/latest/metaobject-definition'
md: 'https://shopify.dev/docs/api/events/latest/metaobject-definition.md'
api_name: events
---
# MetaobjectDefinition
**Requires \`read\_metaobject\_definitions\` access scope.:**
Subscribe to field-level changes on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetaobjectDefinition) GraphQL Admin API object. You can subscribe to create, delete, and update events, and to changes to specific fields.
Each [topic](https://shopify.dev/docs/api/events/latest#configuration) corresponds to a commerce resource, such as a metaobject definition, 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.
You can't use calculated fields, derived fields, auto-updated timestamps, or cross-domain fields as triggers.
Subscriptions can include multiple triggers. Use the `shopify-webhook-id` header for deduplication when handling duplicate deliveries.
You can use custom queries to query the full GraphQL Admin API, not only [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetaobjectDefinition).
## shopify.app.toml
```toml
[events]
api_version = "unstable"
[[events.subscription]]
handle = "my_metaobject_definition_events"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = [
"metaobjectDefinition.displayNameKey",
"metaobjectDefinition.name"
]
uri = "https://your-app.com/events"
query = """
query metaobject_definition_details($metaobjectDefinitionType: String!) {
metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
displayNameKey
name
}
}
"""
```
***
## Supported triggers
`MetaobjectDefinition` subscriptions support the following field-level [triggers](https://shopify.dev/docs/api/events/latest#configuration).
### metaobjectDefinition
Fires when events involve the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition) object.
The `"create"` and `"delete"` actions are only relevant within the context of this parent topic. Use `fields_changed` to follow or replicate impacted data after a delete event. Define a custom query to retrieve specific fields from create events.
Collect details about changes to the object by subscribing to the trigger along with the `"update"` action, though it's recommended that you narrow your subscription to one of the other triggers below.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.access
Fires when the [`access`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.access) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition) 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`.
Access configuration for the metaobject definition.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.access.admin
Fires when the [`admin`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectAccess#field-MetaobjectAccess.fields.admin) field on the [`MetaobjectAccess`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectAccess) 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 `admin` field represents the access permitted on the Admin API.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.access.customerAccount
Fires when the [`customerAccount`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectAccess#field-MetaobjectAccess.fields.customerAccount) field on the [`MetaobjectAccess`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectAccess) 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 `customerAccount` field represents the access permitted on the Customer Account API.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.access.storefront
Fires when the [`storefront`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectAccess#field-MetaobjectAccess.fields.storefront) field on the [`MetaobjectAccess`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectAccess) 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 `storefront` field represents the access permitted on the Storefront API.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities
Fires when the [`capabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.capabilities) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition) 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 `capabilities` field represents the capabilities of the metaobject definition.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.onlineStore
Fires when the [`onlineStore`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.onlineStore) field on the [`MetaobjectCapabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilities) 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`.
Indicates whether a metaobject definition can be displayed as a page on the Online Store.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.onlineStore.data
Fires when the [`data`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesOnlineStore#field-MetaobjectCapabilitiesOnlineStore.fields.data) field on the [`MetaobjectCapabilitiesOnlineStore`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesOnlineStore) 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 `data` field represents the data associated with the Online Store capability.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.onlineStore.data.urlHandle
Fires when the [`urlHandle`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilityDefinitionDataOnlineStore#field-MetaobjectCapabilityDefinitionDataOnlineStore.fields.urlHandle) field on the [`MetaobjectCapabilityDefinitionDataOnlineStore`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilityDefinitionDataOnlineStore) 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 `urlHandle` field represents the URL handle for accessing pages of this metaobject type in the Online Store.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.onlineStore.enabled
Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesOnlineStore#field-MetaobjectCapabilitiesOnlineStore.fields.enabled) field on the [`MetaobjectCapabilitiesOnlineStore`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesOnlineStore) 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`.
Indicates if the capability is enabled.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.publishable
Fires when the [`publishable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.publishable) field on the [`MetaobjectCapabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilities) 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`.
Indicate whether a metaobject definition is publishable.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.publishable.enabled
Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesPublishable#field-MetaobjectCapabilitiesPublishable.fields.enabled) field on the [`MetaobjectCapabilitiesPublishable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesPublishable) 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`.
Indicates if the capability is enabled.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.renderable
Fires when the [`renderable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.renderable) field on the [`MetaobjectCapabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilities) 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`.
Indicate whether a metaobject definition is renderable and exposes SEO data.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.renderable.data
Fires when the [`data`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesRenderable#field-MetaobjectCapabilitiesRenderable.fields.data) field on the [`MetaobjectCapabilitiesRenderable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesRenderable) 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 `data` field represents the data associated with the renderable capability.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.renderable.data.metaDescriptionKey
Fires when the [`metaDescriptionKey`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilityDefinitionDataRenderable#field-MetaobjectCapabilityDefinitionDataRenderable.fields.metaDescriptionKey) field on the [`MetaobjectCapabilityDefinitionDataRenderable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilityDefinitionDataRenderable) 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 `metaDescriptionKey` field represents the metaobject field used as an alias for the SEO page description.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.renderable.data.metaTitleKey
Fires when the [`metaTitleKey`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilityDefinitionDataRenderable#field-MetaobjectCapabilityDefinitionDataRenderable.fields.metaTitleKey) field on the [`MetaobjectCapabilityDefinitionDataRenderable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilityDefinitionDataRenderable) 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 `metaTitleKey` field represents the metaobject field used as an alias for the SEO page title.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.renderable.enabled
Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesRenderable#field-MetaobjectCapabilitiesRenderable.fields.enabled) field on the [`MetaobjectCapabilitiesRenderable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesRenderable) 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`.
Indicates if the capability is enabled.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.translatable
Fires when the [`translatable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.translatable) field on the [`MetaobjectCapabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilities) 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`.
Indicate whether a metaobject definition is translatable.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.translatable.enabled
Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesTranslatable#field-MetaobjectCapabilitiesTranslatable.fields.enabled) field on the [`MetaobjectCapabilitiesTranslatable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectCapabilitiesTranslatable) 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`.
Indicates if the capability is enabled.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.description
Fires when the [`description`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.description) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition) 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 `description` field represents the administrative description.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.displayNameKey
Fires when the [`displayNameKey`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.displayNameKey) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition) 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 `displayNameKey` field represents the key of a field to reference as the display name for each object.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions
Fires when the [`fieldDefinitions`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.fieldDefinitions) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition) 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 `fieldDefinitions` field represents the fields defined for this object type.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.capabilities
Fires when the [`capabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.capabilities) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition) 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`.
Capabilities available for this metaobject field definition.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.capabilities.adminFilterable
Fires when the [`adminFilterable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinitionCapabilities#field-MetaobjectFieldDefinitionCapabilities.fields.adminFilterable) field on the [`MetaobjectFieldDefinitionCapabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinitionCapabilities) 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`.
Indicate whether a metaobject field definition is configured for filtering.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.capabilities.adminFilterable.enabled
Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldCapabilityAdminFilterable#field-MetaobjectFieldCapabilityAdminFilterable.fields.enabled) field on the [`MetaobjectFieldCapabilityAdminFilterable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldCapabilityAdminFilterable) 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`.
Indicates if the capability is enabled.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.description
Fires when the [`description`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.description) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition) 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 `description` field represents the administrative description.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.name
Fires when the [`name`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.name) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition) 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 human-readable name.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.required
Fires when the [`required`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.required) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition) 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`.
Required status of the field within the metaobject composition.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.validations
Fires when the [`validations`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.validations) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition) 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 `validations` field contains a list of validation options for the field.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.visibleToStorefrontApi
Fires when the [`visibleToStorefrontApi`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.visibleToStorefrontApi) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition) 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 `visibleToStorefrontApi` field indicates whether this field is visible within the Storefront API.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.name
Fires when the [`name`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.name) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition) 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 human-readable name.
**Variables:** `metaobjectDefinitionType`
### Examples
* #### Subscribe via app configuration
##### shopify.app.toml
```toml
[events]
api_version = "unstable"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["create"]
triggers = ["metaobjectDefinition"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_details($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "create",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition"
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123']"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: create
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.access"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
access {
__typename
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"access": {
"__typename": "MetaobjectAccess"
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].access"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.access.admin"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
access {
admin
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"access": {
"admin": "…"
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].access.admin"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.access.customerAccount"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
access {
customerAccount
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"access": {
"customerAccount": "…"
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].access.customerAccount"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.access.storefront"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
access {
storefront
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"access": {
"storefront": "…"
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].access.storefront"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
__typename
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"__typename": "MetaobjectCapabilities"
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.onlineStore"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
onlineStore {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"onlineStore": {
"__typename": "MetaobjectCapabilitiesOnlineStore"
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.onlineStore"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.onlineStore.data"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
onlineStore {
data {
__typename
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"onlineStore": {
"data": {
"__typename": "MetaobjectCapabilityDefinitionDataOnlineStore"
}
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.onlineStore.data"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.onlineStore.data.urlHandle"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
onlineStore {
data {
urlHandle
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"onlineStore": {
"data": {
"urlHandle": "…"
}
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.onlineStore.data.urlHandle"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.onlineStore.enabled"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
onlineStore {
enabled
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"onlineStore": {
"enabled": "…"
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.onlineStore.enabled"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.publishable"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
publishable {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"publishable": {
"__typename": "MetaobjectCapabilitiesPublishable"
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.publishable"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.publishable.enabled"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
publishable {
enabled
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"publishable": {
"enabled": "…"
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.publishable.enabled"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.renderable"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
renderable {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"renderable": {
"__typename": "MetaobjectCapabilitiesRenderable"
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.renderable"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.renderable.data"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
renderable {
data {
__typename
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"renderable": {
"data": {
"__typename": "MetaobjectCapabilityDefinitionDataRenderable"
}
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.renderable.data"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.renderable.data.metaDescriptionKey"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
renderable {
data {
metaDescriptionKey
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"renderable": {
"data": {
"metaDescriptionKey": "…"
}
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.renderable.data.metaDescriptionKey"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.renderable.data.metaTitleKey"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
renderable {
data {
metaTitleKey
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"renderable": {
"data": {
"metaTitleKey": "…"
}
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.renderable.data.metaTitleKey"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.renderable.enabled"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
renderable {
enabled
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"renderable": {
"enabled": "…"
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.renderable.enabled"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.translatable"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
translatable {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"translatable": {
"__typename": "MetaobjectCapabilitiesTranslatable"
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.translatable"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.translatable.enabled"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
capabilities {
translatable {
enabled
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"translatable": {
"enabled": "…"
}
}
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].capabilities.translatable.enabled"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.description"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
description
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"description": "Example
"
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].description"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.displayNameKey"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
displayNameKey
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"displayNameKey": "…"
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].displayNameKey"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
fieldDefinitions {
__typename
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"__typename": "MetaobjectFieldDefinition"
}
]
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].fieldDefinitions"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.capabilities"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
fieldDefinitions {
capabilities {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"capabilities": {
"__typename": "MetaobjectFieldDefinitionCapabilities"
}
}
]
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].fieldDefinitions.capabilities"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.capabilities.adminFilterable"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
fieldDefinitions {
capabilities {
adminFilterable {
__typename
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"capabilities": {
"adminFilterable": {
"__typename": "MetaobjectFieldCapabilityAdminFilterable"
}
}
}
]
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].fieldDefinitions.capabilities.adminFilterable"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.capabilities.adminFilterable.enabled"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
fieldDefinitions {
capabilities {
adminFilterable {
enabled
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"capabilities": {
"adminFilterable": {
"enabled": "…"
}
}
}
]
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].fieldDefinitions.capabilities.adminFilterable.enabled"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.description"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
fieldDefinitions {
description
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"description": "Example
"
}
]
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].fieldDefinitions.description"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.name"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
fieldDefinitions {
name
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"name": "…"
}
]
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].fieldDefinitions.name"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.required"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
fieldDefinitions {
required
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"required": "…"
}
]
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].fieldDefinitions.required"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.validations"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
fieldDefinitions {
validations {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"validations": [
{
"__typename": "MetafieldDefinitionValidation"
}
]
}
]
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].fieldDefinitions.validations"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.visibleToStorefrontApi"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
fieldDefinitions {
visibleToStorefrontApi
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"visibleToStorefrontApi": "…"
}
]
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].fieldDefinitions.visibleToStorefrontApi"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.name"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionId: ID!) {
metaobjectDefinition(id: $metaobjectDefinitionId) {
id
name
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition"
}
},
"fields_changed": [
"metaobjectDefinition[id: 'gid://shopify/MetaobjectDefinition/123'].name"
],
"query_variables": {
"metaobjectDefinitionType": "example-metaobjectDefinitionType"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: unstable
shopify-event-id: 44444444-4444-4444-4444-444444444444
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-resource-id: gid://shopify/MetaobjectDefinition/123
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
```
***