# 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.

Category: Marketplaces · Web page: https://bookalyze.com/guides/connect-amazon

## 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 |

> **Note:** 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 Bookalyze:** 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. |

## Related guides

- [Channels: switch off, say who ships, remove, disconnect](https://bookalyze.com/guides/channels.md): 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.
- [Orders: find, filter and read every order](https://bookalyze.com/guides/orders.md): 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.
- [Amazon settlements: bring in, upload, post](https://bookalyze.com/guides/amazon-settlements.md): 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.
- [Automatic review requests: ask every buyer, at the right time](https://bookalyze.com/guides/automatic-review-requests.md): 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.