Contents
Shopify is an e-commerce platform that allows users to set up an online store and sell their products. It helps you manage your orders - from inventory to the point of sale to shipping and returns.
Shopify documentation: API Guide, Authentication
Additional reference: Supported Shopify APIs
Auth type (required): Select OAuth 2.0 as the authentication type for this connection. The form changes depending on the selected authentication type. The OAuth 2.0 authentication type requires configuring the connection from the Shopify app store.
- If you are installing the integration app for the first time you MUST ONLY choose the option Use existing connection.
- If you want to create a new connection on the integration app that is already installed, choose Set up new connection.
- Make sure that the Shopify store you have logged in to and the connection you want to create
with the Shopify store is the same. If you have logged in to a different store
and tried creating a connection, the app will automatically create a connection
in the logged-in store. - Be informed that only the integrator.io account owners can configure the Shopify connection, provided the user has all the permissions from Shopify.
Set up an OAuth 2.0 connection
To configure the connection:
- Click Continue at the Shopify App Store.
- If you are not logged in to the Shopify app, you will be navigated to the page shown in the screenshot below. Click Login or Add app to log in to Shopify.
- The login page appears as shown in the following screenshot. Sign in to your Shopify account.
- Select the required store and you will be navigated to the Celigo - Shopify app.
- The NetSuite SmartConnector name appears on the Shopify listing page.
- Click Add app. The Celigo - Shopify connect page appears.
- Click Install app. The Celigo sign in page appears if the user is not signed in.
- Provide the credentials and click Sign in. The Set up connection page appears.
Use existing connection
IMPORTANT:
- If you are installing the integration app for the first time you MUST ONLY choose the option Use existing connection.
- Make sure that the Shopify store you have logged in to and the connection you want to create
with the Shopify store is the same. If you have logged in to a different store
and tried creating a connection, the app will automatically create a connection
in the logged-in store. - Be informed that only the integrator.io account owners can configure the Shopify connection, provided the user has all the permissions from Shopify.
- Select Use existing connection.
- From the IO integration name dropdown, select Shopify - NetSuite.
- From the Connection dropdown, select Shopify Connection - Offline | yourstorename.
Important: When the integration app is installed, by default a Shopify connection is created in the backend, and you have to authorize by logging in to the correct store. - Click Save & authorize. The Install integration: Shopify - NetSuite page appears.
- Click Configure. The Set up connection page appears.
- Click Save & authorize.
- [Optional]: Click Update app, if the process instructs you to do so. Once you update the app, if the Shopify connection is not configured successfully, go to the Set up connection page, and click Save & authorize.
- The Shopify Connection status appears as Configured and the new connection is now successfully added to your account.
Set up new connection
IMPORTANT: Select Set up new connection only when you want to create a new connection on the integration app that is already installed.
Follow the below instructions:
-
- Name your connection (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting a list of connections you’ve created.
- Store name (read-only): integrator.io automatically fills the selected store. The store name that appears is based on the Shopify store user signed in.
- Auth type (read-only): By default, OAuth 2.0 is selected.
- Click Save & authorize. The Install integration: integration app name page appears. The Shopify Connection status appears as Configured.
The IO integration name dropdown displays the list of integration names, for easy identification of your integration, see the text in grey for the tag of the integration app tile. In the Connection field, after selecting the required connection, the default grey text in the connection name displays the store name as yourstorename. Once the connection is configured successfully, the actual Shopify store name is updated.
FAQs
Q1: Why am I getting the following errors while setting up OAuth 2.0 connection to Shopify?
- Error message: {“errors”:[{“code”:“missing_header”,“message”:“An account is shared with you. Please send the Integrator-AShareId in the request header.“}]}
- Resolution: You are not signed in as an integrator.io account owner. Be informed that only the integrator.io account owners can configure the Shopify connection, provided you have all the permissions from Shopify.
- Error message: Oauth error invalid_request: This app is requesting to be installed and your account doesn't have permission to grant the requested access. You can fix this issue by reinstalling the app as the account owner.
- Resolution: You don't have the right set of permissions in Shopify. Make sure that you either have owner access in Shopify or access to all the permissions needed by the app.
Q2: In what instance should I select the option Set up new connection?
A: You must use this option only when you want to create a new connection on the integration app that is already installed.
Q3: Why do I still see the following screen even after configuring the setup correctly?
A: There is a high chance that you might have selected the option Set up new connection instead of the option Use existing connection. Go to the Use existing connection section and follow the instructions explained.
Comments
3 comments
I've messed this up a few times and the instructions need to be a little clearer when installing a new connection.
Can you make it clear at the top of the help that if you are installing the integration app for the first time you MUST only choose the Use existing connection. It seems optional and if I've never connected this store it makes no sense to chose Use Existing. Put that in bold.
Also - Step 3 below is unintuitive. You have to choose and existing connection to create a new one? Confusin. Can you name that connection in step 3 differently? replace yourstorename with selecttomakenewconnection or something.
Thanks, David Gollom. We have considered your first suggestion and updated the help doc. Regarding the second suggestion, we are in discussions with the product team, we will get back to you once we make the decision. Thanks for the valuable feedback!
Thank for taking my suggestion. I think that'll help others who may have previously worked in IO and are used to how things usually function.
Please sign in to leave a comment.