Connect Amazon Ads
Unlike the Seller Partner API (which covers your whole Seller account in a single connection), the Amazon Advertising API is per region. Each region has its own Ads account and requires its own consent flow. You can connect any or all of them — or none, if you don’t run PPC ads.
In this guide:
- Open the Ads connection screen
- Authorize each region you advertise in
- Verify campaigns appear
Prerequisites
- You’ve completed Connect your Amazon Seller account.
- An Amazon Advertising account in each region you want to connect. Ads accounts are created the first time you run a campaign in Seller Central; if you’ve never advertised, there’s nothing to connect.
- You’re an Owner or Admin in your Hilal organization.
Step 1: Open the Ads connection screen
In Hilal, go to Settings → Amazon Accounts in the sidebar (or click Connect Amazon Ads on the welcome screen). You’ll see separate region cards for each Amazon Advertising region. Each shows a Connect button.
Step 2: Authorize Hilal in Advertising
Click Connect on the region you want to authorize. You’re redirected to advertising.amazon.com for that region (or the regional equivalent).
Sign in with the Amazon account that owns the Ads profile in that region (it can be the same account as your Seller, or different). Approve the requested permissions:
- Read campaigns — campaign metadata, ad groups, keywords, ASINs.
- Read reports — performance data, attribution, ACoS.
- Write campaigns — create, pause, resume, and edit campaigns when you do so from inside Hilal.
Click Allow. Amazon redirects you back to Hilal. The region card flips to Connected, showing the connection date and status.
Step 3: Connect additional regions
Repeat Step 2 for any other regions you sell in. Each region is independent — you can connect them all on day one or come back later.
Step 4: Verify campaigns appear
Open Advertising in the sidebar. The campaign list populates with the campaigns Amazon returned from the connected regions. The first sync can take a few minutes for large accounts.
If the list is empty after 5 minutes:
- Check that the Ads account in that region actually has campaigns.
- Refresh the page to check for newly synced campaigns.
Troubleshooting
- “No advertising accounts found.” The Amazon account you signed in with doesn’t own an Ads profile in that region. Sign in with a different Amazon account.
- “Region already connected.” You — or a teammate — already authorized this region. Either use the existing connection or disconnect and reconnect if needed.
- “Insufficient permissions.” Your Hilal role doesn’t have permission to connect Ads. Ask an Owner or Admin.
What’s next
Tell Hilal which marketplaces your business actually sells in so the entire app scopes its data correctly.