---
title: WebhookSubscriptionMetafieldIdentifier - GraphQL Admin
description: >-
  Webhook subscriptions let you receive instant notifications when important

  events happen in a merchant's store, so you can automate workflows and keep
  your

  systems in sync without constantly polling for updates.


  For example, a subscription might monitor `orders/create` events and send JSON

  payloads to `https://yourapp.com/webhooks/orders` whenever customers place new

  orders, enabling immediate order processing workflows.


  Use the `WebhookSubscription` object to:

  - Monitor active webhook configurations

  - Access subscription details like topics, endpoints, and filtering rules

  - Retrieve creation and update timestamps for audit purposes

  - Review API versions and format settings

  - Examine metafield namespace configurations for extended data access


  Each subscription includes comprehensive configuration details such as the

  specific Shopify events being monitored, the destination endpoint (HTTP,

  EventBridge, or Pub/Sub), event filtering criteria, and payload customization

  settings. The subscription tracks its creation and modification history.


  Subscriptions can include advanced features like Shopify search syntax for
  event filtering to control

  which events trigger notifications, specific field inclusion rules to control
  which fields are included

  in the webhook payload, and metafield namespace access to capture custom store
  data. The API version

  is inherited from the app that created the webhook subscription.


  The endpoint configuration varies by type - HTTP subscriptions include
  callback

  URLs, EventBridge subscriptions reference AWS ARNs, and Pub/Sub subscriptions

  specify Google Cloud project and topic details. This flexibility allows apps
  to

  integrate webhooks with their preferred infrastructure and event processing
  systems.


  Learn more about [webhook subscription
  management](https://shopify.dev/docs/apps/webhooks).
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/WebhookSubscriptionMetafieldIdentifier
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/WebhookSubscriptionMetafieldIdentifier.md
api_name: admin
api_type: graphql
type: object
---

# Webhook​Subscription​Metafield​Identifier

object

Webhook subscriptions let you receive instant notifications when important events happen in a merchant's store, so you can automate workflows and keep your systems in sync without constantly polling for updates.

For example, a subscription might monitor `orders/create` events and send JSON payloads to `https://yourapp.com/webhooks/orders` whenever customers place new orders, enabling immediate order processing workflows.

Use the `WebhookSubscription` object to:

* Monitor active webhook configurations
* Access subscription details like topics, endpoints, and filtering rules
* Retrieve creation and update timestamps for audit purposes
* Review API versions and format settings
* Examine metafield namespace configurations for extended data access

Each subscription includes comprehensive configuration details such as the specific Shopify events being monitored, the destination endpoint (HTTP, EventBridge, or Pub/Sub), event filtering criteria, and payload customization settings. The subscription tracks its creation and modification history.

Subscriptions can include advanced features like Shopify search syntax for event filtering to control which events trigger notifications, specific field inclusion rules to control which fields are included in the webhook payload, and metafield namespace access to capture custom store data. The API version is inherited from the app that created the webhook subscription.

The endpoint configuration varies by type - HTTP subscriptions include callback URLs, EventBridge subscriptions reference AWS ARNs, and Pub/Sub subscriptions specify Google Cloud project and topic details. This flexibility allows apps to integrate webhooks with their preferred infrastructure and event processing systems.

Learn more about [webhook subscription management](https://shopify.dev/docs/apps/webhooks).

## Fields

* key

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  The unique identifier for the metafield definition within its namespace.

* namespace

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  The container for a group of metafields that the metafield definition is associated with.

***

## Map

### Fields with this object

* [WebhookSubscription.metafields](https://shopify.dev/docs/api/admin-graphql/latest/objects/WebhookSubscription#field-WebhookSubscription.fields.metafields)