Connecting your Shopify store

Step 1 — Create the app in the Dev Dashboard

1. Open the Dev Dashboard

   Go to dev.shopify.com and sign in with the account that owns your store. Shopify has moved this entry point around inside the store admin, so going straight to the Dev Dashboard is the reliable route.

2. Create the app

   Click Create app and give it a name, for example IcloneU. You'll land on the app's overview page, with Versions, Installs and Configuration in the left menu.

Step 2 — Grant the API scopes

1. Open the scopes field

   In the app's left menu open Versions, then find the API access section and its Scopes field. Scopes are entered here as a comma-separated list, not ticked from a list of checkboxes.

2. Add the five required scopes

   read_orders, read_customers, read_products, read_inventory, read_locations. These cover product and stock questions, order lookups, and knowing which locations can ship.

3. Add the ones for the extras you want

   write_draft_orders lets your clone send a checkout link — add this one unless you specifically don't want that. write_price_rules lets it create discount codes. read_content lets you import your store's pages and blog articles into a Knowledge library.

4. Save and release a version

   Save the configuration, then release a version of the app. Scope changes only take effect once a version is released.

Step 3 — Install the app on your store

Creating the app and releasing a version does not install it. This step is easy to miss, and without it the connection has nothing to talk to.

1. Go back to the app's main page

   Click the app's name (for example IcloneU) in the left menu to return to its overview.

2. Install it

   In the Installs section click Install app, then pick your store. Shopify shows you the permissions the app is asking for before it installs.

3. Copy the credentials

   Open the app's Configuration and copy the Client ID and Client Secret (use the eye icon to reveal the secret). Unlike the old tokens, you can come back and read these again later.

Step 4 — Connect the store in IcloneU

1. Open the connector

   In IcloneU go to Automations → Connectors → Shopify → Connect.

2. Shop Domain

   Your store's .myshopify.com domain, for example my-store.myshopify.com — not your custom domain.

3. Client ID and Client Secret

   Paste both values from Step 3. A store still on a pre-2026 custom app pastes its shpat_... token into the legacy token field instead — one or the other, never both.

4. Save

   Save the connection. IcloneU checks the credentials against your store straight away, so a mistake shows up here rather than later.

Step 5 — Order notifications (for automatic review requests)

Automatic review requests need IcloneU to hear from your store when an order is fulfilled. Review requests are scheduled on fulfilment, not on payment — a paid order that hasn't shipped won't trigger one.

Legacy shpat_... connections only. Automatic registration needs a Client Secret, so a store still on an old token creates the notification by hand:

1. Open webhook settings

   Store admin → Settings → Notifications → scroll to the Webhooks section.

2. Create it

   Click Create webhook. Choose the event for order fulfilment being created — Shopify's wording for this varies by language and changes from time to time, so pick the fulfilment-creation event rather than looking for an exact label. Format: JSON. URL: your IcloneU address followed by /api/ShopifyWebhook.

3. Copy the signing secret

   At the bottom of the same Webhooks section Shopify shows "All your webhooks will be signed with …" followed by a key. Copy it.

4. Paste it into IcloneU

   Edit your Shopify connection and paste it into Webhook Signing Secret. Without it, IcloneU ignores your store's notifications for safety.

Step 6 — Test it end to end

1. Ask your clone about a product

   The fastest check. In the Playground or from a connected channel, ask about something you sell. A working connection answers with the real product, its variants and whether they can ship — not with something invented.

2. Enable automatic requests

   In IcloneU: Reviews → Settings — enable automatic requests, set the delay days (use 0 for a quick test), pick the WhatsApp channel and your approved template.

3. Create a test order

   In Shopify: Orders → Create order → add a product → create a customer with your own WhatsApp number in international format → mark as paid.

4. Fulfil it

   Open the order and click Fulfil items. Fulfilment is the trigger — marking it paid is not enough.

5. Check the result

   Within about a minute (with delay 0) the WhatsApp template arrives naming the product from the order. The buyer appears under Contacts and the request under Reviews → Requests.