--- title: webhookSubscriptionsCount - GraphQL Admin description: |- The count of webhook subscriptions. 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). Limited to a maximum of 10000 by default. api_version: 2025-10 api_name: admin type: query api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/queries/webhookSubscriptionsCount?example=receive-a-count-of-all-webhooks md: https://shopify.dev/docs/api/admin-graphql/latest/queries/webhookSubscriptionsCount.md?example=receive-a-count-of-all-webhooks --- # webhook​Subscriptions​Count query The count of webhook subscriptions. 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). Limited to a maximum of 10000 by default. ## Arguments * limit [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int) Default:10000 The upper bound on count value before returning a result. Use `null` to have no limit. * query [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/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](https://shopify.dev/api/usage/search-syntax). * created\_at time * endpoint string * * id id * topic string - Filter by `id` range. - Example: * `id:1234` * `id:>=1234` * `id:<=1234` * updated\_at time *** ## Possible returns * Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) Details for count of elements. *** ## Examples * ### Receive a count of all Webhooks #### Query ```graphql query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } } ``` #### Variables ```json { "query": "topic:\"orders/create\"" } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } }", "variables": { "query": "topic:\"orders/create\"" } }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } }`, { variables: { "query": "topic:\"orders/create\"" }, }, ); const json = await response.json(); return json.data; } ``` #### Ruby ```ruby session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } } QUERY variables = { "query": "topic:\"orders/create\"" } response = client.query(query: query, variables: variables) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } }`, "variables": { "query": "topic:\"orders/create\"" }, }, }); ``` #### Response ```json { "webhookSubscriptionsCount": { "count": 1, "precision": "EXACT" } } ``` ## Receive a count of all Webhooks [Open in GraphiQL](http://localhost:3457/graphiql?query=query%20WebhookSubscriptionsCount\(%24query%3A%20String!\)%20%7B%0A%20%20webhookSubscriptionsCount\(query%3A%20%24query\)%20%7B%0A%20%20%20%20count%0A%20%20%20%20precision%0A%20%20%7D%0A%7D\&variables=%7B%0A%20%20%22query%22%3A%20%22topic%3A%5C%22orders%2Fcreate%5C%22%22%0A%7D) ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } }`, { variables: { "query": "topic:\"orders/create\"" }, }, ); const json = await response.json(); return json.data; } ``` ##### GQL ``` query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } } ``` ##### cURL ``` curl -X POST \ https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } }", "variables": { "query": "topic:\"orders/create\"" } }' ``` ##### React Router ``` import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } }`, { variables: { "query": "topic:\"orders/create\"" }, }, ); const json = await response.json(); return json.data; } ``` ##### Node.js ``` const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } }`, "variables": { "query": "topic:\"orders/create\"" }, }, }); ``` ##### Ruby ``` session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query WebhookSubscriptionsCount($query: String!) { webhookSubscriptionsCount(query: $query) { count precision } } QUERY variables = { "query": "topic:\"orders/create\"" } response = client.query(query: query, variables: variables) ``` ## Input variables JSON ```json { "query": "topic:\"orders/create\"" } ``` ## Response JSON ```json { "webhookSubscriptionsCount": { "count": 1, "precision": "EXACT" } } ```