WebhookSubscriptionCreatePayload

The list of errors that occurred from executing the mutation.

The webhook subscription that was created.

Creates a webhook subscription that notifies your App when specific events occur in a shop. Webhooks push event data to your endpoint immediately when changes happen, eliminating the need for polling.

The subscription configuration supports multiple endpoint types including HTTPS URLs, Google Pub/Sub topics, and AWS EventBridge event sources. You can filter events using Shopify API search syntax to receive only relevant webhooks, control which data fields are included in webhook payloads, and specify metafield namespaces to include.

Note: The Webhooks API version <a href="https://shopify.dev/docs/apps/build/webhooks/subscribe/use-newer-api-version">configured in your app</a> determines the API version for webhook events. You can&#39;t specify it per subscription.

Building an app? If you only use app-specific webhooks, you won't need this. App-specific webhook subscriptions specified in your shopify.app.toml may be easier. They are automatically kept up to date by Shopify & require less maintenance. Please read About managing webhook subscriptions.