Webhook JSON payload, but in GraphQL schema

Technical Q&A

Topic summary

A developer is concerned about the future of webhook JSON payloads as the REST Admin API is being sunset in favor of GraphQL.

Core Issue:

  • Webhook payloads currently follow REST Admin API JSON schema
  • REST Admin API is being phased out with GraphQL replacing it
  • Uncertainty exists about what happens to webhook payload formats when REST is fully deprecated

Key Questions:

  • Will webhook JSON payloads transition to GraphQL schema format?
  • Is there already a way to receive webhooks in GraphQL response format?
  • How much investment should be made in solutions dependent on current REST-based webhook schemas?

Current State:

  • No apparent alternative to REST-formatted webhook payloads exists
  • No clear migration path from REST to GraphQL schema for webhooks

The discussion remains open with no responses yet, seeking clarification on the platform’s roadmap for webhook payload formats during this API transition.

Summarized with AI on October 27. AI used: claude-sonnet-4-5-20250929.
1

Right now webhook https payload follows REST Admin API JSON schema. However, REST Admin is being sunset, and GraphQL is taking over.

I expect that soon REST Admin API will be completely shut down, and at that point what is going to happen with JSON webhook payload format? Is there a plan to change webhook JSON payload schema to follow that being used in responses to GraphQL queries? Maybe there is already a way to receive webhook JSON payload arranged just as GraphQL responses are?

The reason this is important, at least to me, is I would like to know how much time and effort I can invest into solutions which depend on webhook payloads that follow REST Admin API schema. Right now it seems that there is no real alternative, but at the same time there is also no way to transition away from REST Admin API to GraphQL schema.