Webhook subscriptions now support a name field for identification

You can now assign an optional name to your webhook subscriptions to simplify identification and management. This feature is available for both TOML-based subscriptions and subscriptions created through the Admin API subscriptions created via the GraphQL Admin API.

Naming your webhooks is particularly beneficial when you have multiple subscriptions targeting the same endpoint or listening to the same topic with different filters. When a webhook is delivered, its name is included in the request headers, allowing you to route and process incoming webhooks without needing to parse the payload body.

For admin API subscriptions, the webhook name must be unique per shop. For declarative subscriptions, the name must be unique per app. Names can be up to 50 characters long and may include alphanumeric characters, underscores, and hyphens.

To set a name for TOML-based subscriptions, update the name field in your shopify.app.toml webhook configuration. From 2026-04, you can name admin API subscriptions, the name field can be set using the WebhookSubscription GraphQL object, as well as through the webhookSubscriptionCreate and webhookSubscriptionUpdate mutations.