---
title: >-
  webhookSubscriptionCreate and webhookSubscriptionUpdate support all URI types
  - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/consolidate-webhook-graphql-surfaces'
  md: 'https://shopify.dev/changelog/consolidate-webhook-graphql-surfaces.md'
metadata:
  effectiveApiVersion: 2025-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2024-12-20T12:19:38-05:00'
  postedAt: '2025-08-08T12:00:00-04:00'
  updatedAt: '2025-07-30T11:24:50-04:00'
  effectiveAt: '2025-01-31T12:00:00-05:00'
---

August 8, 2025

Tags:

* Admin GraphQL API
* 2025-10

# `webhookSubscriptionCreate` and `webhookSubscriptionUpdate` support all URI types

The [`webhookSubscriptionCreate`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/webhookSubscriptionCreate) and [`webhookSubscriptionUpdate`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/webhooksubscriptionupdate) GraphQL mutations now support a unified [`uri`](https://shopify.dev/docs/api/admin-graphql/2025-10/input-objects/WebhookSubscriptionInput#fields-uri) field in the [`webhookSubscription` (`WebhookSubscriptionInput`)](https://shopify.dev/docs/api/admin-graphql/2025-10/input-objects/WebhookSubscriptionInput) argument, which accepts:

* HTTPS URLs
* Google Pub/Sub URIs (`pubsub://{project-id}:{topic-id}`)
* Amazon EventBridge event source ARNs

The [`WebhookSubscription`](https://shopify.dev/docs/api/admin-graphql/2025-10/objects/WebhookSubscription) object has been updated to include this new [`uri`](https://shopify.dev/docs/api/admin-graphql/2025-10/objects/WebhookSubscription#field-WebhookSubscription.fields.uri) field, and the [`webhookSubscriptions`](https://shopify.dev/docs/api/admin-graphql/2025-10/queries/webhooksubscriptions) query now supports filtering by [`uri`](https://shopify.dev/docs/api/admin-graphql/2025-10/queries/webhooksubscriptions#arguments-uri) to accommodate all endpoint types.

### Deprecations

The following endpoint-specific mutations are now deprecated in favor of the unified approach:

* [`eventBridgeWebhookSubscriptionCreate`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/eventbridgewebhooksubscriptioncreate)
* [`eventBridgeWebhookSubscriptionUpdate`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/eventbridgewebhooksubscriptionupdate)
* [`pubSubWebhookSubscriptionCreate`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/pubsubwebhooksubscriptioncreate)
* [`pubSubWebhookSubscriptionUpdate`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/pubsubwebhooksubscriptionupdate)

Additionally, the [`callbackUrl`](https://shopify.dev/docs/api/admin-graphql/2025-10/queries/webhooksubscriptions#arguments-callbackUrl) field in the [`webhookSubscriptions`](https://shopify.dev/docs/api/admin-graphql/2025-10/queries/webhooksubscriptions) query is deprecated (previously supported HTTPS URLs only).

### Migration Notes

Use the new `uri` field in [`webhookSubscriptionCreate`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/webhookSubscriptionCreate)/[`webhookSubscriptionUpdate`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/webhooksubscriptionupdate) mutations and [`webhookSubscriptions`](https://shopify.dev/docs/api/admin-graphql/2025-10/queries/webhooksubscriptions) query instead of the deprecated endpoint-specific mutations and [`callbackUrl`](https://shopify.dev/docs/api/admin-graphql/2025-10/queries/webhooksubscriptions#arguments-callbackUrl) field.