All Tutorials

Manage Webhook API versions

All Tutorials

Manage Webhook API versions

Manage Webhook API versions

Like the majority of Shopify’s APIs, webhook resources are versioned. Make sure your app is updated regularly to use a supported webhook version.

Select a webhook API version for a public app

  1. From your Partner Dashboard, go to Apps.
  2. Click the app that you want to update.
  3. Click App setup.
  4. In the Webhooks section, select an API version from the Webhook API version drop-down-list.
  5. Click Save.

Select a webhook API version for a private app

  1. From the Shopify admin, go to Apps.
  2. Click Manage private apps.
  3. Click the private app that you're updating.
  4. In the Admin API section, select an API version from the Webhook API version drop-down list.
  5. Click Save.

Select a webhook API version for Shopify admin notifications

  1. From the Shopify admin, go to Settings > Notifications.
  2. Click Create webhook, or click an existing webhook.
  3. If this is a new webhook, then enter the event, format, and URL.
  4. Select an API version from the Webhook API version drop-down list.
  5. Click Save webhook.

Update your app to use a newer webhook API version

Before you select a newer webhook API version, you need to test it against your app.

Step 1: Update your code

Add logic to your code so that your app handles webhooks differently depending on their API version. To check the API version, your app can use the X-Shopify-Api-Version request header in every webhook POST request.

Step 2: Test the newer API version

From your development store's notification settings, add some webhooks that use the newer version, and then send some test payloads. Webhooks created from your app continue to use the older API version.

Check that your app correctly handles the test webhooks, and make any necessary adjustments to your code.

Step 3: Select the newer API version

Select the newer API version for your public or private app. All webhooks sent to your app will now use this version.

Step 4: Test that webhooks are working

Test that your app handles webhooks correctly.

Step 5: Remove references to the older API version

Update your code to remove the logic that you added, and all the references to the old webhook API version.