ScopeNotGrantedError

Topic summary

Developers are encountering a ScopeNotGrantedError when attempting to access customer personal data (phone numbers, emails) through their Shopify apps.

The issue appears after migrating apps to Shopify’s new next-generation Developer Dashboard. Despite having the necessary permissions previously enabled, the platform no longer recognizes these permissions post-migration.

Impact: Multiple developers report being unable to:

  • Access buyer identity data using hooks like useEmail
  • Continue local development work
  • Use extensions that previously functioned correctly

Current Status: The discussion remains unresolved with no known fix or workaround identified. Developers are seeking assistance from the Shopify team but have not yet received a solution. Screenshots showing the error messages are included in the original thread.

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

Hello everyone,

I’m encountering an issue with customer data access. Previously, I was able to access customer phone numbers and other personal details with the necessary permissions enabled. However, after migrating to the new Shopify Developer Dashboard, my extensions are now returning the following error:

ScopeNotGrantedError: Using buyer identity requires having personal customer data permissions granted to your app.

It seems like the permissions are not being recognized correctly after the migration. Has anyone else experienced this issue or found a solution?

1 Like

Also experiencing this exact issue after migrating. Did you find a fix?

I also have the same issue - on a test version of my app I used to be able to useEmail but since it has been migrated to the next-gen platform I am now seeing the same ScopeNotGrantedError

This is preventing me from developing my app locally

I am not sure how I can add someone from the shopify team, as I am not able to do my development, and it’s not getting resolved as well.
@alex_dover @smernick3 Sorry But I have not found anything yet.

Anyone know how we can tag someone from the shopify team?
Hello, @Laza_Binaery @tim_1 @Howie10 can any of you please help us?

Your help is appreciated.

Hi @easy

I cannot help you much. I think, before the new dev dashboard, there was a specific setting in the partners dashboard for customer data. And now that is different. First thing to check is your app .toml file. And not just dev one but one you push to production. And double-check if you have a few toml files, which one is linked
shopify app config link

And you probably searched the dev docs, but do try AI assistant, sometimes it can help.
Manage access scopes top links “Assistant”

Hello @easy

This error, “ScopeNotGrantedError: Using buyer identity requires having personal customer data permissions granted to your app,” indicates that your app is trying to access what Shopify categorizes as “protected customer data” without the explicit, and newly required, permissions.

With recent updates, especially around API version 2022-10 and later, Shopify has become more stringent about apps accessing customer’s personally identifiable information (PII). Even if your app had permissions previously, the migration to the new Developer Dashboard often requires a re-confirmation or a new request for this access.

How to Fix the Issue: Requesting Access to Protected Customer Data

Even for development, custom, or private apps, you now need to formally request access to protected customer data through the Shopify Partner Dashboard. For non-public apps, this approval is typically granted automatically and immediately.

Here are the steps to resolve the error:

  1. Navigate to Your App’s Settings:

    • Go to your Shopify Partner Dashboard.

    • Click on Apps and select the app you are having issues with.

  2. Find the API Access Section:

    • In your app’s settings, locate the API access or a similarly named section.
  3. Request Protected Customer Data Access:

    • Look for a section titled Protected customer data access and click on Request access.

    • You will likely be presented with a form where you need to specify why your app needs access to this data.

    • Select “Protected customer data” and provide a reason for its use.

    • You will also need to select the specific fields your app requires, such as the customer’s name, email, and phone number, and justify why each is needed.

  4. Save and Submit:

    • After filling out the required information, save your changes.

    • If your app is not public (i.e., it’s a custom app or used only for development), you shouldn’t need to submit it for a formal review, and the permissions should be granted automatically.

Important Considerations After Migration

  • Development vs. Production: This issue often appears in development environments after the migration, while the production version of the extension might still be working correctly. This is because the new developer dashboard and CLI enforce these checks more rigorously in development.

  • Shopify CLI and Configuration: The migration to the new Developer Dashboard often involves updating the Shopify CLI. App configurations, including access scopes, might now be primarily managed in the shopify.app.toml file. Ensure that your required scopes are correctly defined there.

  • Data Minimization: Be aware that Shopify’s review process (for public apps) adheres to the principle of data minimization. This means you should only request the data that is absolutely essential for your app’s functionality.

By re-requesting the permissions for protected customer data within your app’s settings, you should be able to resolve the ScopeNotGrantedError and once again access the necessary customer details in your extensions.

Thank You!

Have you tried searching at dev forums – https://community.shopify.dev/ ?

Thanks for the quick reply, everyone.

@Laza_Binaery Yes I am aware of that part, and that is the problem i even tried with a direct url hit, but the pageis not available so I can’t submit the request again.

@websensepro Thanks, But I think this solution will not work as there is no such section now. the tabs and settings you are suggesting those are removed by shopify in there last release after new developer dashboard.

Yes, @tim_1 i tried searching the comunity first but can’t find any help so i created this ticket but i think people are having this problem after migrating to the new developer dashboard and not able to use the customer data.

Shopify employees are more frequent there, so you may have better luck asking your question in dev forums.

I’m not a developer so I can’t help you much there. I did find something similar tho.