---
title: WebhookSubscription - GraphQL Admin
description: >-
  A webhook subscription is a persisted data object created by an app using the
  REST Admin API or GraphQL Admin API.

  It describes the topic that the app wants to receive, and a destination where
  Shopify should send webhooks of the specified topic.

  When an event for a given topic occurs, the webhook subscription sends a
  relevant payload to the destination.

  Learn more about the [webhooks system](https://shopify.dev/apps/webhooks).
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/WebhookSubscription
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/WebhookSubscription.md
---

# Webhook​Subscription

object

A webhook subscription is a persisted data object created by an app using the REST Admin API or GraphQL Admin API. It describes the topic that the app wants to receive, and a destination where Shopify should send webhooks of the specified topic. When an event for a given topic occurs, the webhook subscription sends a relevant payload to the destination. Learn more about the [webhooks system](https://shopify.dev/apps/webhooks).

## Fields

* apiVersion
* createdAt
* filter
* format
* id
* includeFields
* legacyResourceId
* metafieldNamespaces
* metafields
* topic
* updatedAt
* uri

### Deprecated fields

* callbackUrl: deprecated
* endpoint: deprecated

***

## Map

### Fields and connections with this object

* [WebhookSubscriptionConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/WebhookSubscriptionConnection#returns-nodes)
* [WebhookSubscriptionEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/WebhookSubscriptionEdge#field-WebhookSubscriptionEdge.fields.node)

***

## Queries

* webhookSubscription
* webhookSubscriptions

***

## WebhookSubscription Queries

### Queried by

* [webhook​Subscription](https://shopify.dev/docs/api/admin-graphql/latest/queries/webhookSubscription)
* [webhook​Subscriptions](https://shopify.dev/docs/api/admin-graphql/latest/queries/webhookSubscriptions)

***

## Mutations

* webhookSubscriptionCreate
* webhookSubscriptionUpdate

### Deprecated mutations

* eventBridgeWebhookSubscriptionCreate: deprecated
* eventBridgeWebhookSubscriptionUpdate: deprecated
* pubSubWebhookSubscriptionCreate: deprecated
* pubSubWebhookSubscriptionUpdate: deprecated

***

## WebhookSubscription Mutations

### Mutated by

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

***

## Interfaces

* LegacyInteroperability
* Node

***

## WebhookSubscription Implements

### Implements

* [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability)
* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)