Skip to content

docs(shopify): document Protected Customer Data requirement - #527

Merged
guitavano merged 1 commit into
mainfrom
guitavano/shopify-protected-customer-data-docs
Jul 28, 2026
Merged

docs(shopify): document Protected Customer Data requirement#527
guitavano merged 1 commit into
mainfrom
guitavano/shopify-protected-customer-data-docs

Conversation

@guitavano

@guitavano guitavano commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #526.

Using the customer tools (SHOPIFY_LIST_CUSTOMERS, lookups, segments, order→customer joins) fails with:

This app is not approved to access the Customer object. See https://shopify.dev/docs/apps/launch/protected-customer-data …

even with the read_customers scope granted. That's Shopify's Protected Customer Data gate — a separate, app-level approval independent of OAuth scopes. It's a Partner-dashboard configuration, not a code issue (the MCP already surfaces the error with a clear hint).

Adds a README section covering:

  • what the gate is and the exact error,
  • the Partner Dashboard steps to grant it (level 1 protected data + level 2 PII fields, questionnaire, reconnect),
  • the option to drop read_customers from SHOPIFY_SCOPES if customer data isn't needed.

Docs-only — no code or registry.json change (the registry readme comes from mesh_description, not README.md).

🤖 Generated with Claude Code


Summary by cubic

Add README guidance for Shopify’s Protected Customer Data so customer tools work and the “not approved to access the Customer object” error is avoided. Also notes how to remove read_customers if customer data isn’t needed.

  • Migration
    • Partner Dashboard → Apps → your app → API access → request “Protected customer data” (level 1) and, if needed, “Protected customer fields” (level 2).
    • Complete the questionnaire, then re-run OAuth to reconnect.
    • If not using customer data, remove read_customers from SHOPIFY_SCOPES.

Written for commit 63be6e8. Summary will update on new commits.

Review in cubic

read_customers alone doesn't grant Customer object access — Shopify gates it
behind a separate app-level Protected Customer Data approval. Add a README
section with the exact error, the Partner Dashboard steps, and the option to
drop read_customers from SHOPIFY_SCOPES.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@guitavano
guitavano merged commit d31fe35 into main Jul 28, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant