The Shopify connector is onboarded through Connect's onboarding wizard. This step-by-step plan contains the following steps:
- Step 1 – Selecting the connector
- Step 2 – Preset
- Step 3 – Authentication
- Step 4 – Billing Information
- Step 5 – Summary
- Step 6 – Confirmation
- Step 7 – First import and activation
To onboard the Shopify connector, keep the following credentials at hand:
- API key
- Admin API access token
- API secret Key
- Shop URL
Step 1 – Selecting the connector
When logging into Connect, click the New connector button on the dashboard. This will open the onboarding wizard.
Select the Shopify connector from the list of available connectors. If you want to move to a different tab in Connect at any time during the onboarding process, you can save the connector as a draft. When Shopify is selected, click Next.
Step 2 – Preset
For Shopify, you can select three presets:
- E-commerce with e-fulfilment
- E-commerce with marketing automation
- E-commerce with marketplaces
Each of these three presets has its configuration, which is set up to work best with either e-fulfilment, marketing automation, or marketplaces. Read more about presets and when to select which. Select the preset you want to continue with, or choose Configure connector manually to manually set up the connector. Click Next.
Please note
When configuring the connector manually, it is recommended to familiarise yourself with the available options first. For detailed information, read our manual integration article.
Step 3 – Authentication
Enter the API credentials, the access token, and the shop URL of the shop you want to connect. We recommend using the Admin API Access token authentication method, as it's most secure. Click Next.
If the credentials are not valid, one of the following errors may occur:
| Message | Solution |
|---|---|
| We can't connect with the integration. Check if all inputs have been filled in correctly. | Recheck the API credentials. |
| An issue has occurred. | The Shopify API is not online. Please try again later. |
| We can't connect with the given URL. Check the URL and try again. | Contact Connect support. |
| An unknown issue has occurred. | Contact Connect support. |
Please note
When you are creating API credentials in Shopify, please make sure that they have access to both 'Read' and 'Write' permissions for the following scopes: Assigned fulfillment orders, Customers, Draft orders, Fulfillment Services, Inventory, Locations, Merchant-managed fulfillment orders, Orders, Product Listings, Products, Shipping, Third-party fulfillment orders, All_cart_transforms, Custom_fulfillment_services.
Step 4 – Billing Information
To continue, fill out any remaining billing information. This step may automatically be skipped if all information has been filled out previously. Click Next.
Step 5 – Summary
A summary of the selected preset for the integration will be displayed. The blue underlined text is clickable and represents a preset configuration. Any configuration options that still need to be completed will appear as questions or placeholders on this screen. These must be configured before proceeding. Once completed, click Next.
Step 6 – Confirmation
This is the final step before the connector is activated. Once Next is clicked, the connector will be created, and data import will begin. Click Next to activate the connector.
Step 7 – First import and activation
After activation, the import progress can be tracked through the progress bars. The connector will now import data from your Shopify shop. By default, the connector will import data looking back a predetermined amount of time:
- Orders: 7 days
- Products: 10 years
- Contacts: 10 years
This means that for this initial import, any order from the past 7 days will be imported into Connect. It also means that virtually any product and customer that has ever been created (and not deleted) will be imported into Connect as well.
Depending on the amount of data being imported, the first import can take up to an hour. This screen can be navigated away from and reopened later by clicking the Shopify connector icon on the dashboard home screen.
While exporting, the status icon below the connector icon may still display as inactive. Some time after the first export, the status will change to ‘operational’. An email confirmation will also be sent when the first export is complete. Once you have received this email, the connector is operational.
Your connector is now operational. Any products and orders that are imported are visible in their respective tabs in the dashboard. New orders, products and checkouts will be imported as they are created in the Shopify shop itself.