Returns webhook API

Shopify Discussion

Topic summary

A developer has registered a returns/update webhook that appears correctly configured but fails to trigger when returns are created in the store.

Configuration verified:

  • Webhook properly registered in webhooks.json with API version 2024-07
  • Endpoint address is valid (confirmed working with other webhooks like orders/updated)
  • Event version set to 2024-04 in configuration

The problem:

  • When a return is created with status “Return in progress”, the returns/update webhook doesn’t fire
  • The orders/updated webhook triggers successfully for the same events
  • No failed requests appear in Shopify’s Webhooks insights/logs, and the topic itself isn’t showing in the logs

Current status:
The issue remains unresolved. A second user has confirmed experiencing the same problem, but no solutions or explanations have been provided yet.

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

I have created a webhook for “returns/update”. I’ve checked the webhooks.json and can see that it has been correctly registered.

{
    "webhooks": [
        {
            "id": 1531278754071,
            "address": "https://address/webhook/returns/update",
            "topic": "returns/update",
            "created_at": "2024-06-30T08:21:33+01:00",
            "updated_at": "2024-06-30T08:21:33+01:00",
            "format": "json",
            "fields": [],
            "metafield_namespaces": [],
            "api_version": "2024-07",
            "private_metafield_namespaces": []
        },
        {
            "id": 1531278786839,
            "address": "https://address/webhook/orders/updated",
            "topic": "orders/updated",
            "created_at": "2024-06-30T08:21:34+01:00",
            "updated_at": "2024-06-30T08:21:34+01:00",
            "format": "json",
            "fields": [],
            "metafield_namespaces": [],
            "api_version": "2024-07",
            "private_metafield_namespaces": []
        }
    ]
}
  • I’ve checked the address and it’s valid (I’ve changed the domain in the example above). I have another webhook registered and it works just fine.
  • I’ve checked the Event version in the configuration and that is “2024-04”.
  • Looking at insights / Webhooks does not show “returns/update” in the “Webhooks topics” logs. I would expect if the address was wrong to see failed requests.

As far as I can tell everything is configured correctly for “returns/update”.

When I create a return in the store the “returns/update” event doesn’t trigger. The “orders/updated” webhook does but not the “returns/update”. I can see the line item in the store with a status to “Return in progress (1)”.

Has anyone managed to get this working?

2

I have the same issue - any updates?