Troubleshooting: Shopify Access

Resolving revoked permissions for Shopify integrations.

Troubleshooting
Updated Aug 2026
Owner: Integration Engineering
Area: Integrations

Before you begin

Restore a Shopify grant safely when StoreFulfil reports lost access, without exposing credentials or losing the client’s connection context.

Prerequisites

  • The Admin can open the affected Client Detail page.
  • The client can authorise the displayed Shopify invite or connection action.
  • The Shopify Store Owner or authorised Admin is available for the grant step.

Stop and check

Do not paste tokens, recreate credentials, or keep fulfilment running on a connection that fails health.

If StoreFulfil loses API access, synchronisation stops.

Resolution Steps

  1. Check the connection health in the Client Detail view.
  2. Generate a new reauthorisation invite for the client.
  3. Once authorised, run a client sync to ensure alignment.

Expected Outcome

API access is restored.

Runbook evidence

Use these signals to decide whether the work is ready to continue, complete, or needs an owner.

State checkpoints

Healthy access

The connection health check can use the current Shopify grant.

Next: Use the normal sync path and monitor its result.

Access lost

Shopify rejected the current grant or the connection health check failed.

Next: Generate the supported reauthorisation path and have the client authorise it.

Reauthorised

The new grant exists, but dependent data is not confirmed until a sync succeeds.

Next: Run one client sync and verify the visible result.

Completion evidence

  • The health check is successful and the post-authorisation sync result is visible.

Escalation evidence

  • Record the client, health result, authorisation time, sync result, and displayed error without links or secrets.

Work safely

Who may take this action

Warehouse Admin

What you should see

The connection health check can use the current Shopify grant.

Safe next step

Use the normal sync path and monitor its result.

What not to do

Do not paste tokens, recreate credentials, or keep fulfilment running on a connection that fails health.

How to tell it is complete

The health check is successful and the post-authorisation sync result is visible.