---
title: WebhookSubscriptionCreatePayload - GraphQL Admin
description: Return type for `webhookSubscriptionCreate` mutation.
api_version: 2025-10
api_name: admin
type: payload
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/payloads/webhooksubscriptioncreatepayload
  md: https://shopify.dev/docs/api/admin-graphql/latest/payloads/webhooksubscriptioncreatepayload.md
---

# Webhook​Subscription​Create​Payload

payload

Return type for `webhookSubscriptionCreate` mutation.

## Fields

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/UserError)

  non-null

  The list of errors that occurred from executing the mutation.

* webhook​Subscription

  [Webhook​Subscription](https://shopify.dev/docs/api/admin-graphql/latest/objects/WebhookSubscription)

  The webhook subscription that was created.

***

## Mutations with this payload

* [webhook​Subscription​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/webhookSubscriptionCreate)

  mutation

  Set up webhook subscriptions so your app gets notified instantly when things happen in a merchant's store. Instead of constantly checking for changes, webhooks push updates to your app the moment they occur, making integrations faster and more efficient.

  For example, an inventory management app might create subscriptions for `orders/paid` and `inventory_levels/update` events to automatically adjust stock levels and trigger fulfillment processes when customers complete purchases.

  Use `webhookSubscriptionCreate` to:

  * Set up real-time event notifications for your app
  * Configure specific topics like order creation, product updates, or customer changes
  * Define endpoint destinations (HTTPS, EventBridge, or Pub/Sub)
  * Filter events using Shopify search syntax to receive notifications only for relevant events
  * Configure field inclusion to control which data fields are included in webhook payloads

  The mutation supports multiple endpoint types and advanced filtering options, allowing you to create precisely targeted webhook subscriptions that match your app's integration needs. The API version is inherited from the app configuration and cannot be specified per subscription. Filters use Shopify search syntax to determine which events trigger notifications.

  Successful creation returns the webhook subscription fields that you request in your query. The mutation validates topic availability, filter syntax, and endpoint configuration.

  Learn more about [creating webhook subscriptions](https://shopify.dev/docs/apps/build/webhooks/subscribe).

  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](https://shopify.dev/docs/apps/build/webhooks/subscribe).

***

## Map

### Mutations with this payload

* [webhook​Subscription​Create](https://shopify.dev/docs/api/admin-graphql/latest/types/webhookSubscriptionCreate)