Connect your store
What each platform needs, where to find it in your store admin, and what Insights does with it.
Open your dashboardBefore you start
Insights connects to your store’s own API with keys you create in your store admin. It uses them only to read orders, products, customers, categories and, on WooCommerce, coupons. The keys are stored encrypted, and Integrations only ever shows part of each one.
Only the owner or an admin can connect a store. For WooCommerce and Magento, enter your live store address starting with https://. For Shopify, use your .myshopify.com address.
Each account connects one store. Once it’s connected, the Connect Store button no longer shows on Connected Stores. To switch to a different store, contact support; the current store has to be disconnected first.
WooCommerce
WooCommerce connects with a REST API key: a Consumer Key (starts with ck_) and a Consumer Secret (starts with cs_). Your store must use HTTPS.
Read permission is enough to sync. Choose Read/Write only if you want Insights to set up real-time webhooks through the API. The connector plugin on Sync Data sets them up without write access.
- In WordPress admin, go to WooCommerce → Settings → Advanced → REST API and click Add key.
- Enter a description such as Ignitix Insights, choose an administrator as the user, and set Permissions to Read.
- Click Generate API key and copy the Consumer key and Consumer secret. WooCommerce shows the secret only once.
- In Insights, paste them into Consumer Key and Consumer Secret and press Connect Store.
Shopify
The app recommends Connect with Shopify OAuth. Shopify asks you to approve read access to products, customers and orders, then sends you back to Insights, which takes the store name and currency from Shopify and starts the first sync.
If you already have a custom app in your Shopify admin, you can paste its Admin API access token (starts with shpat_) into Access Token instead. It needs the read_products, read_customers and read_orders scopes.
- Choose Shopify, enter a Store Name and your Store URL as https://yourstore.myshopify.com, and press Next.
- On API Credentials, press Connect with Shopify OAuth.
- Sign in to Shopify if asked and approve the request.
- Wait for the Store Connected! message. Insights then opens your store’s analytics.
Magento 2
Magento connects with an integration access token, pasted into Bearer Token. On Magento 2.4.4 and later, also set Stores → Settings → Configuration → Services → OAuth → Consumer Settings → Allow OAuth Access Tokens to be used as standalone Bearer tokens to Yes.
Integration tokens don’t expire by default. An admin token does, after 4 hours. If you use one, add an admin login under Settings → Magento Admin Credentials and Insights fetches a new token when the old one runs out.
- In Magento admin, go to System → Extensions → Integrations and click Add New Integration.
- Enter a Name and your admin password. On the API tab, give access to Sales, Catalog, Customers and Stores.
- Click Save, then Activate next to the integration, then Allow.
- Copy the Access Token, paste it into Bearer Token in Insights and press Connect Store.
Check the connection
Connect Store tests your keys with your store before saving anything. If the test fails, the screen says what to check and nothing is saved, so you can fix the keys and press Connect Store again. If it passes, the store is saved and the first sync starts.
To check a connected store later, open Integrations and press Test under Store Connection. You should see Connection successful!.
If your keys change, press Edit Credentials, paste the new keys and press Save, then Test again. Fill in the key fields every time; leave Store URL empty to keep the current address.