Create a Shopify Staff Account (with the right permissions) to generate an API key for Catchr

Why this matters

To connect Shopify to Catchr, your teammate (Staff user) must be able to:

1. Access store data (Orders / Products / Customers in “View” mode), and

2. Create a Shopify custom app + generate an Admin API access token (Shopify often calls this “Develop apps” + enabling custom app development). Shopify Help Center+2Shopify+2

1. Create the Staff account in Shopify

These steps must be done by the Store owner or a user who can manage users/roles.

1. In Shopify Admin, go to Settings → Users and permissions.

2. Click Add user (or Add staff) and enter the staff member’s email.

3. Assign a role (recommended: create a dedicated role like “Catchr – Shopify connector” so permissions are easy to audit).

4. Send invite and have the staff member accept it.

2. Assign the required permissions (minimum set)

Edit the staff user’s role and grant exactly the following permissions:

Store permissions

• Orders → View

• Products → View

• Customers → View

• App Development

  • View apps developed by staff and collaborators.

    • Develop

    • Enable development

App development permissions

In the role’s App and sales channel permissions section, grant:

• Manage and install apps and channels

• Approve app charges

Shopify’s own guidance is that staff/collaborators need Develop apps to create/edit custom apps, and they also need the relevant store permissions to assign scopes (API permissions) for the data they will access.

3. Let the Staff user create the custom app + API token

Once permissions + development are enabled, the staff user can:

1. Go to Apps → Develop apps.

2. Click Create an app, name it (e.g., “Catchr”), and create it.

3. In the app, open Configure Admin API scopes and select read scopes that match the permissions above (read orders / returns / products / customers).

4. Install the app in the store.

5. In API credentials, copy the Admin API access token (this is the “API key” Catchr will use).

5) Create the Shopify Source in Catchr

In Catchr:

1. Go to Sources → Add source → Shopify

2. Paste the required values (typically Shopify store domain + the Admin API access token from the custom app)

Common issues (quick fixes)

• Staff user can’t see “Develop apps”: confirm the role has App development permissions and that Allow custom app development is enabled. Shopify Help Center+1

• Can’t select the needed API scopes: the staff user is missing the related store permissions (Orders/Products/Customers → View) in their role.

• “API credentials” missing / token not visible: ensure the app is installed and you’re in the correct custom app screen in Shopify admin (UI can differ by store/org).