Skip to main content
Connecting Shopify lets the AdStellar agent ground its analysis in your real store data — actual orders, revenue, and average order value — instead of only what Meta reports. It also unlocks conversion-aware recommendations (for example, holding off on a Sales-optimized campaign until your pixel has purchase signal).

​
Before you start

Shopify does not offer AdStellar a one-click sign-in. The connection works through a Shopify custom app that you create in your own store — this takes about five minutes, and you only do it once. You’ll need store owner or admin access.

​
Connect your store

1

Create the custom app in Shopify

In your Shopify admin, go to Settings → Apps and sales channels → Develop apps (or the Apps section of the Shopify Dev Dashboard). Create a new app — any name works, e.g. “adstellar-integration”.
2

Add the Admin API scopes

Configure the app’s Admin API access scopes to include at least read_products, read_orders, and read_customers. If the AdStellar connect window lists additional scopes when you connect, approve those too — the connection only works if the app grants everything it asks for.
3

Copy the Redirect URI exactly

The AdStellar connect window shows a Redirect URI (a pipedream.com callback URL that performs the secure handshake). Copy it exactly as shown — no added or missing trailing slash, no spaces — into your app’s Allowed redirection URL(s) field in Shopify. A single character of difference makes Shopify reject the connection with “The redirect_uri is not whitelisted”.
4

Release and install the app

Release a version of the app and install it on your store before connecting. Connecting against an unreleased or uninstalled app fails after sign-in with a generic “Account connection failed” message.
5

Connect from AdStellar

Click Integrations in the left sidebar, find Shopify (under Ecommerce, or search for it), and click Connect. Enter your Shop ID (the yourstore part of yourstore.myshopify.com) and the app’s Client ID and Client Secret (from the app’s settings page in Shopify), then approve.
6

Wait for the Connected badge

After you approve, the AdStellar side finishes the handshake — this normally takes a few seconds, and at most two minutes. When the card shows a Connected badge, you’re done.
The Redirect URI must match exactly. Paste it only into Allowed redirection URL(s) — the separate App URL field is where merchants land when they open the app from their admin, and setting it to the callback URL is harmless but not required.

​
Troubleshooting

​
”Oauth error invalid_request: The redirect_uri is not whitelisted”

Shopify is rejecting the callback because the Redirect URI the connect window sends is not in your app’s Allowed redirection URL(s), character for character. Re-copy the Redirect URI from the connect window and compare it against the app’s list — watch for a missing path segment, a trailing slash, or an http/https difference. If you retried the connection several times, re-check the value on the latest attempt.

​
”Account connection failed” after approving

This appears after Shopify hands back to the connect window, and almost always means one of:
  1. The app version isn’t released or installed on the store. Release a version in the Dev Dashboard and install it, then retry.
  2. A scope is missing. The app must grant every scope the connect window requests — re-check the app’s Admin API scopes.
  3. The Client Secret changed. If you rotated the secret in Shopify, re-enter the current one.
Retry once after fixing the cause — transient Shopify hiccups are also common.

​
The window spins forever or “Shopify isn’t loading”

The connection handshake times out after 2 minutes with a clear error instead of spinning indefinitely. If it times out:
  1. Close the window and retry once.
  2. Sign in as the store owner or an admin — staff accounts without app-install permission can log in but can’t authorize the connection.
  3. Disable popup blockers / ad blockers for app.adstellar.ai, or retry in an incognito window (rules out extension conflicts).
  4. Use your yourstore.myshopify.com address when Shopify asks for the store, not your custom domain.

​
Still stuck?

If the connection fails twice in a row, contact us via the in-app chat and include:
  • Your store’s .myshopify.com address
  • What you saw (error message, timeout, or infinite spinner)
  • The browser you used
Failed connect attempts that reach our app are logged on our side with the provider’s error text, so the support agent can usually look up exactly which step failed for your store.

​
What the agent can do once connected

Ask in plain language and the agent uses your real store data automatically:
  • “What was my real Shopify revenue last week vs. what Meta reported?”
  • “What’s my AOV this month?”
  • “Which campaign drove the most actual orders?”
See Connectors & Custom MCP for tool permissions and workspace access controls.