A
argbe.tech - news
1min read

Shopify webhook naming unlocks clearer identification for multi-app routing

Shopify added a name field to webhook subscriptions, making it easier to identify and route events across multi-app environments. The name can be carried in request headers for faster, cleaner webhook dispatch.

Shopify supports custom webhook subscription names (up to 50 characters) starting with the 2026-04 GraphQL Admin API version, improving identification and routing in multi-app environments.

  • Names accept alphanumeric characters plus underscores and hyphens, giving teams a consistent label for each integration path.
  • The subscription name is included in webhook request headers, enabling header-based routing without parsing the webhook payload body.
  • Admin API-created subscriptions require the name to be unique per shop, reducing ambiguity when multiple subscriptions target similar endpoints.
  • Declarative subscriptions require uniqueness per application, and the name can be set in shopify.app.toml for TOML-based app configs.
  • Naming is supported via webhookSubscriptionCreate and webhookSubscriptionUpdate, and appears on the WebhookSubscription GraphQL object.