GraphQL API 2025-07 – Deprecation warning for WebhookSubscription.endpoint before uri field is available

Webhooks and Events
1

Hi,

I’d like to report an issue related to the Shopify GraphQL API version 2025-07.

I’m running the following query:

{
  webhookSubscriptions(first: 100) {
    nodes {
      id
      topic
      filter
      endpoint {
        ... on WebhookHttpEndpoint {
          callbackUrl
        }
      }
    }
  }
}

In response, I receive the following header:

x-shopify-api-deprecated-reason: WebhookSubscription.endpoint

According to the documentation (link), the current endpoint field is deprecated and is supposed to be replaced by a new uri field, which will only be available in API version 2025-10.

Right now, I can’t update to the future API version, as 2025-10 isn’t publicly available yet. However, I’m already getting warnings and errors in my logs about the deprecated field, which creates unnecessary noise and makes it harder to spot real issues.

In my opinion, the deprecation warning should only be triggered once version 2025-10 (with the uri field) is officially released, not already in 2025-07, since there’s currently no alternative available.

Could you please verify this?

Thanks!

2

I’ve started getting this as well, but I can’t find any information on this call being deprecated. Through the PHP package they have it log this:

{
    "url":"https://srs-demo-store.myshopify.com/admin/api/2025-07/graphql.json",
    "reason":"WebhookSubscription.endpoint"
}

Which arguably isn’t very useful information, but even worse, I started getting this on 2025-04 and 2025-07 isn’t even released yet. For some reason 2025-07 is still marked as Release Candidate…

3

Hey folks - thanks for flagging this behaviour, looking into this now on my side.

4

Hey folks,

Our recommendation is that you can already migrate to the 2025-10 version to prevent this from appearing; otherwise this message is safe to ignore because it is a deprecation and not a removal.