API token is missing some scopes

Last updated on Nov 04, 2022
Applies To Shopify.
Error Message Text(s) Some Object(s) in my Shopify Pipeline failed with the following reason: “API token seems to be missing following scopes: <scope_name(s)>”.

Potential Causes

You may get this error if your Shopify app is missing the required permissions on some objects you are trying to ingest.

Suggested Actions

This can be resolved in two ways:

  • Create a new app in Shopify, grant the required permissions, and reconfigure the Source by providing the new admin API password.

  • Grant the required permissions in your existing Shopify app, and restart the failed object(s) in Hevo. To do so:

    1. Edit the admin API access scopes in Shopify:

      1. Log in to your Shopify Store Admin account.

      2. In the left navigation pane, click Apps, and then in the search bar, click App and sales channel settings.

        Shopify Apps

      3. In the Apps and sales channels page, click Develop apps.

        Develop apps

      4. In the App development page, select the app for which you want to edit the scopes.

        Select app

      5. In the Configuration tab, Admin API integration section, click Edit.

        Edit scopes

      6. Under the Admin API access scopes section, select the read_<scope_name> check box for the following scopes:

        1. Discounts

        2. Draft orders

        3. Fulfillment services

        4. Inventory

        5. Marketing events

        6. Orders

        7. Price rules

        8. Product listings

        9. Products

        10. Shipping

        11. Shopify Payment disputes

        12. Shopify Payment payouts

      7. Click Save.

    2. Restart the failed object(s) in Hevo:

      1. Go to the Hevo Pipeline where you received the failure.

      2. Click the More ( More icon ) icon corresponding to the object(s) that failed, and then click Restart Object.

        Restart objects


Revision History

Refer to the following table for the list of key updates made to this page:

Date Release Description of Change
Aug-10-2022 NA New document.

Tell us what went wrong