Starter plan & up

Connecting Amazon SP-API

How to connect your Amazon Seller account and Amazon Ads account with API credentials so Ordinary can report your Amazon sales, financials, inventory and Sponsored Products spend alongside Shopify.

Ordinary Written by The Ordinary Team · Updated
On this page

Amazon reporting requires Starter or higher. Shopify-only stores can skip this integration. If your store moves to a plan without Amazon reporting while it’s connected, the connection keeps syncing so your Amazon reports are complete again the moment you upgrade; disconnect it (see Disconnecting below) to stop syncing.

Connecting Amazon brings your Amazon business into Ordinary — your selling performance (sales and traffic, financials, inventory, and orders) and your Sponsored Products advertising — so you can see it alongside your Shopify revenue.

Before you start

  • You’re on Starter or higher.
  • You can create apps in Amazon’s developer consoles: one for the Selling Partner API (SP-API) and one for Amazon Ads. Each gives you a Client ID, Client Secret and Refresh Token.
  • You know your Marketplace ID (for SP-API) and your Amazon Advertising Profile ID.

What we connect to

Ordinary uses two Amazon APIs in tandem:

  • SP-API (Selling Partner API) — your Amazon Seller account business data: sales and traffic metrics, financials (fees and refunds), inventory levels, and order records.
  • Amazon Ads API — Sponsored Products performance at campaign level. Sponsored Brands and Sponsored Display aren’t imported.

All access is read-only — Ordinary reads your Amazon data and never creates, edits, or changes anything in your Amazon account.

Connecting your account

Amazon connects with API credentials rather than a sign-in button. Go to Settings → Amazon, which has two cards:

Amazon SP-API — “Connect your Amazon Seller account for sales, traffic and financial reporting.” Fill in:

  • Client ID and Client Secret — from your SP-API app in the Amazon developer console.
  • Refresh Token — generated when you authorize that app.
  • Marketplace ID — the marketplace your store sells in.

Amazon Ads API — “Connect your Amazon Advertising account for Sponsored Products campaign data.” Fill in:

  • Client ID and Client Secret — from your Amazon Ads app, which is a separate app from the SP-API one.
  • Refresh Token — from the Amazon Ads authorization, separate from the SP-API token.
  • Profile ID — your Advertising profile. Profiles map to a single marketplace, so use the one for your primary market.

On each card, click Test Connection to check the credentials, then Save. Reach out to support@tryordinary.com if you’d like a hand.

Importing history

Connecting doesn’t import history on its own. To bring it in, click Backfill 2 years on the Historical backfill card. It pulls the last two years (730 days) of Sponsored Products campaign performance and order history in the background, so you can navigate away while it runs. Settings → Sync Status shows progress.

After it’s connected

  • Marketing Mix — an Amazon Ads card shows Amazon-reported orders, sales and spend, with your top campaigns. These are sales made on Amazon as Amazon reports them, not Shopify store revenue. Amazon spend is included in the page’s blended ROAS. See Channels — Amazon Ads.
  • Financials (Advanced) — an Amazon view with per-product margins after Amazon’s fees. See Product financials.
  • Inventory (Advanced) — your Amazon stock levels alongside your Shopify inventory. See Inventory.

Refresh cadence

  • Amazon Ads — once a day, in the morning (UTC). Each sync re-pulls several recent days, because Amazon keeps updating attributed sales for a while after a click.
  • Orders — every hour.
  • Sales and traffic, financials and inventory — once a day.

There’s no manual refresh button; syncs run on their own.

Amazon’s own attribution windows are preserved as-is — we don’t remap them.

Disconnecting

There’s no Disconnect button on Settings → Amazon. To stop syncing, contact support@tryordinary.com. You can also revoke the apps’ access in your Amazon developer consoles, which stops Ordinary reading from Amazon straight away.

Troubleshooting

  • Test Connection fails — re-check each value against the right developer console. SP-API and Amazon Ads use separate apps, so their Client IDs, Client Secrets and Refresh Tokens are different.
  • Ads data missing — check the Profile ID matches the marketplace you advertise in.
  • Spend is zero but I’m running ads — see Amazon data looks wrong.

Did this answer your question?

Thanks for your feedback! 🙌

Related articles