Shopify

OAuthE-commerceOrg connection

Org-level connection

Shopify is connected once at the org level by an admin. The credential is shared across all groups that have been granted access — individual team members don't need to connect their own accounts.

How to connect

1

Click Connect Shopify below to authorize access to your store.

Ready to connect?

Go directly to the integrations page in your dashboard.

Open Integrations →

Permissions (scopes)

These are the data scopes On Belay can be granted for Shopify. Your org admin controls which scopes are enabled per group.

ScopeDescriptionAccess
read_productsRead productsRead only
write_productsWrite productsRead / Write
read_ordersRead ordersRead only
write_ordersWrite ordersRead / Write
read_customersRead customersRead only
write_customersWrite customersRead / Write
read_inventoryRead inventoryRead only
write_inventoryWrite inventoryRead / Write
read_contentRead contentRead only
write_contentWrite contentRead / Write
read_analyticsRead analyticsRead only

Troubleshooting

"redirect_uri_mismatch" error during OAuth

Your OAuth app's authorized redirect URIs don't include the On Belay callback URL. Add https://app.onbelay.ai/api/oauth-callback/shopify to the allowed redirect URIs in your OAuth app settings.

"invalid_scope" error

The API or scope isn't enabled in your cloud project. For Google integrations, make sure the relevant API (e.g., Google Ads API, Search Console API) is enabled in Google Cloud Console for your project.

Connected but Claude can't access data

Check that your group has been granted access to this integration in On Belay → Groups → [your group] → Integrations. Also verify the specific scopes your group is permitted to use match what your query requires.

Still stuck? We're happy to help.

Contact support →