Skip to main content
Anchor to WebhookSubscriptionConnection

WebhookSubscriptionConnection

connection

An auto-generated type for paginating through multiple WebhookSubscriptions.

Anchor to Queries with this connectionQueries with this connection

•query

Retrieves a paginated list of webhook subscriptions created using the API for the current app and shop.


Note

Returns only shop-scoped subscriptions, not app-scoped subscriptions configured in TOML files.


Subscription details include event topics, endpoint URIs, filtering rules, field inclusion settings, and metafield namespace permissions. Results support cursor-based pagination that you can filter by topic, format, or custom search criteria.

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.

Arguments

•Int

The first n elements from the paginated list.

•String

The elements that come after the specified cursor.

•Int

The last n elements from the paginated list.

•String

The elements that come before the specified cursor.

•Boolean
Default:false

Reverse the order of the underlying list.

•WebhookSubscriptionSortKeys
Default:CREATED_AT

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

•String

A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.

Anchor to created_at
•time
•id

Filter by id range.

Example:

  • id:1234
  • id:>=1234
  • id:<=1234
Anchor to updated_at
•time
•URL
Deprecated
•String

URI to filter by. Supports an HTTPS URL, a Google Pub/Sub URI (pubsub://{project-id}:{topic-id}) or an Amazon EventBridge event source ARN.

•WebhookSubscriptionFormat

Response format to filter by.

•[WebhookSubscriptionTopic!]

List of webhook subscription topics to filter by.



Was this section helpful?

•[WebhookSubscriptionEdge!]!
non-null

The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node.

•[WebhookSubscription!]!
non-null

A list of nodes that are contained in WebhookSubscriptionEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve.

•PageInfo!
non-null

An object that’s used to retrieve cursor information about the current page.


Was this section helpful?