Connect Amazon: get your Selling Partner API keys

Create a private Selling Partner API app for your own seller account, give it the roles Bookalyze needs, and paste its client ID, client secret and refresh token. About 15 minutes, plus Amazon's review of a new developer profile.

What you'll need

Amazon lets a seller build a private app that only reads their own account. Bookalyze uses yours, so your data goes from Amazon straight into your company. You'll paste four things into Bookalyze:

Value	Where it comes from
Region	North America, Europe (with the Middle East and India), or Far East
LWA client ID	Your app in Seller Central → Develop Apps
LWA client secret	The same place, next to the client ID
Refresh token	Made when you choose Authorize on the app

Tip: You need to be the primary account holder, or a user with permission to manage apps, to do this in Seller Central.

1. Register as a developer (first time only)

1
Open Develop Apps
In Seller Central, open Apps and Services → Develop Apps. If you've never built an app, Amazon asks you to fill in a developer profile first.
2
Choose a private developer
Say you're building an app to integrate your own business with Amazon (a private developer), not one to sell to other sellers.
3
Pick the roles you'll need
Tick the roles in the table below. A role your profile doesn't have can't be given to an app later without updating the profile.
4
Wait for Amazon
Amazon reviews new developer profiles. It can take a few days; you'll get an email when it's approved.

Tip: Each Amazon region is a separate seller account. If you sell in North America and in the UAE, you make one app, and authorise it once for each region's account.

2. Which roles to give the app

Bookalyze only asks Amazon for what each feature needs. Give the app the roles for the features you'll use; you can add more later.

Role in Seller Central	What Bookalyze uses it for
Inventory and Order Tracking	Orders and their items
Finance and Accounting	Settlements, refunds, and checking refunds before a review request
Buyer Solicitation	Review requests (Amazon's own Request a Review)
Buyer Communication	Sending a buyer invoice through Amazon
Tax Invoicing	The buyer's name and tax number on an invoice (only if your profile has it)
Amazon Fulfillment	FBA stock and the FBA inventory ledger
Product Listing	Listing watch, and changing prices
Pricing	Prices, offers and Amazon's fee estimates
Selling Partner Insights	Review topics on listing watch (some stores only)

Caution: Don't tick a role your developer profile doesn't have (Tax Invoicing is the usual one). Amazon then refuses the whole connection check, and Bookalyze shows Amazon's own words so you can see which.

3. Create the app and authorise it

1
Add a new app client
In Develop Apps, choose Add new app client. Name it ("Bookalyze" is fine), choose the SP API type and tick the roles from the table.
2
Copy the LWA credentials
Open the app's LWA credentials (View). Copy the client ID and the client secret.
3
Authorise it for your account
Choose Authorize on the app, then Authorize app. Amazon shows a refresh token once. Copy it.

Caution: Treat the client secret and refresh token like passwords. Paste them only into Bookalyze. If one leaks, rotate the secret in Develop Apps and authorise again.

4. Paste them into Bookalyze

Where in the app: Commerce → Channels → Add a channel → Amazon

1
Choose the region
The region of the seller account you authorised: North America (Amazon.com, .ca, .com.mx), Europe (including Amazon.ae, .sa, .eg and India), or Far East.
2
Paste the client ID, client secret and refresh token
Bookalyze checks them with Amazon straight away and saves them encrypted. You won't see them again.
3
Choose your marketplaces
Every marketplace the account sells on becomes a channel in its own currency. Switch off the ones you don't use.
4
Choose when orders start
On Commerce → Orders, pick the day to bring orders in from (the start of your financial year is the default, up to two years back).

What you should see

The Amazon region shows Connected on Commerce → Channels
Your marketplaces are listed, each in its currency
Orders start arriving within minutes (a first sync of thousands takes a few hours, on its own)

Changing roles later

When you add a role to the app (say Buyer Solicitation, to start review requests), Amazon only applies it to a new refresh token. Choose Authorize again in Develop Apps, then on the channel's page choose Replace credentials and paste the new token.

If something goes wrong

You see	What to do
Amazon refused the credentials	Check the client ID and secret were copied whole, and the refresh token is from Authorize, not the secret.
A role is missing (Bookalyze names it)	Add the role to the app, authorise again, and paste the new refresh token.
Access denied on Amazon.ae, .sa or .eg	Usually a role the developer profile lacks (Tax Invoicing, or Selling Partner Insights). Remove it from the app, or add it to the profile, then authorise again.

Channels: switch off, say who ships, remove, disconnect
Every Amazon marketplace, Walmart country, Noon country and eBay site is a channel in its own currency. Switch one off, say who ships its orders, remove one added by mistake, or disconnect an account.
Read the guide
Orders: find, filter and read every order
Every order from every marketplace in one list, with tabs, search and badges for refunds, claims and replacements. Orders are for running the business; they don't post to your books.
Read the guide
Amazon settlements: bring in, upload, post
Every Amazon settlement comes in on its own and reads line by line. Upload older ones, or rebuild years of history from one date range transaction report, then post each as one entry.
Read the guide
Automatic review requests: ask every buyer, at the right time
Switch it on once and Bookalyze asks every eligible Amazon buyer for a review on the day you choose after delivery, skipping refunds, claims and anyone you leave out. It's Amazon's own Request a Review, so it's within Amazon's rules.
Read the guide