Meta is not sent via webhook ORDERS_FULFILLED

Ask & Offer

Topic summary

Issue: An order metafield (“noteOnShipping”) is not included in the JSON payload of the ORDERS_FULFILLED webhook.

Context:

  • A custom order metafield was added to store extra shipping notes.
  • A webhook for the ORDERS_FULFILLED event (triggered when an order is fulfilled) is active.
  • Using API version 2025-04; the webhook payload does not contain the metafield.

Constraints:

  • Avoiding an additional GraphQL API request to fetch metafields due to lack of framework/authentication in the webhook script.

Key questions:

  • Do newer API versions include order metafields in the ORDERS_FULFILLED webhook payload?
  • Where to find changelogs detailing payload changes across API versions?
  • Is there a way to access order metafields in the webhook without making a separate API call?

Status: Unresolved; seeking guidance on version behavior or alternatives without extra requests.

Summarized with AI on February 2. AI used: gpt-5.
1

Hi there,

I added a metafield for orders “noteOnShipping”.
Also I created a webhook for ORDERS_FULFILLED.

But in the big JSON body of this webhook the metafield is nowhere to be found.
It would be pretty unhandy to sent an additional GraphQL request just to get the meta info, because I have no framework nor authentication interface in the webhook script.

Currently I’m using API version 2025-4. Would it work with a more current version? I couldn’t find the changelogs for these versions, so I tend to not changing it.

Thanks in advance!

Cheers
Nick

2

Order metafields are not included in ORDERS_FULFILLED webhook payloads in any API version. This is by design. Shopify webhooks only deliver core resource fields and do not expand custom metafields, even when using webhook customization. Upgrading the API version won’t change this. To access order metafields, a follow-up REST or GraphQL request is required, or the value needs to be written into a core order field (like note or tags) earlier if it must be available in the webhook.

Docs: