Connecting Your Shopify Shop to Corjl (API Integration)

Overview

Corjl's Shopify API integration provides the most complete Shopify experience, including:

• Automatic order syncing
• Product variations
• Buy Now demo links
• Product linking

If you're using Shopify Basic, see our Shopify Webhooks integration instead.

Before You Begin

You'll need:

• A Corjl seller account
• A Shopify Grow (or higher) plan
• Admin access to your Shopify store
• Your Shopify .myshopify.com store URL

Step 1 — Create a Shopify App

1. Log in to the Shopify Dev Dashboard.
2. Select Apps, then click Create app.
3. In the box that opens, click Create app manually (you don't need the Shopify CLI command).
4. Enter an app name, for example Corjl Integration.
5. Under API access, in Scopes, enter: read_orders,read_products (write_orders  and write_products also work, since each includes its read permission).
6. Click Create app, then click Release.

Step 2 — Configure App Permissions

Only needed if you created the app without the scopes above.

1. Open the app in the Dev Dashboard and go to Versions.
2. Click Create version.
3. Under API access, in Scopes, enter: read_orders,read_products
4. Click Release, then Release again.
5. If the app is already installed on your store, see "Missing Permission Error" below: Shopify does not apply new permissions to an installed app until you approve them.

Step 3 — Request Protected Customer Data Access

Some Shopify stores require additional customer data permissions.

If your app includes a Storefront API section:

1. Open Settings.
2. Select Manage next to Storefront API.
3. Choose API access requests.
4. Click Request access.

Request access for:

• Protected customer data
• Name
• Email
• Phone
• Address

Complete Shopify's prompts and save each request.

Step 4 — Install the App

1. In the Dev Dashboard, select Apps.
2. Click the ... button at the end of your app's row and choose Install app.
3. Select the Shopify store you want to connect.
4. Review the requested permissions and click Install.

Step 5 — Open Shopify Integration in Corjl

In Corjl:

1. Click your username.
2. Select Settings.
3. Open Integrations.
4. Select Shopify.
5. Choose API Integration.

Step 6 — Enter Your Shopify Credentials

Fill out the connection form:

Shop Name

Your preferred display name.

Shop URL

Your .myshopify.com address.

Example:

myshop.myshopify.com

Client ID

Copy the Client ID from your Shopify app's Settings page.

Client Secret

Copy the Secret from the same Settings page.

Step 7 — Connect

Click Connect.

If everything is configured correctly, Corjl will confirm that your Shopify shop has been connected successfully.

You can now begin linking products and automatically creating Corjl orders from Shopify purchases.

Troubleshooting

Connection Failed

Double-check that:

• Your app has been Released
• Your app has been Installed
• Both required permissions are enabled:
  • read_orders
  • read_products
• You're using your .myshopify.com URL
• Client ID and Client Secret were copied correctly

Missing Permission Error

Corjl says the app is missing read_orders  or read_products :

1. In the Dev Dashboard, open the app's Versions and check that the active version lists both scopes. If not, follow Step 2.
2. If you added the scopes after installing the app, approve them on your store: in your Shopify admin, open Apps in the left menu, click your app, and click Update on the page that lists the new permissions.
3. Return to Corjl and click Connect (or Re-connect) again.

Prefer Shopify Webhooks?

If you're using Shopify Basic or don't need product variations or Buy Now demo links, you can connect using Shopify Webhooks instead.

The Webhook integration supports:

• Basic order syncing
• Automatic order creation

It does not support:

• Product variations
• Buy Now demo links

See Connect Your Shopify Shop Using Webhooks for setup instructions.