> For the complete documentation index, see [llms.txt](https://integrations.drivetrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integrations.drivetrain.ai/integration-guide/readme/others/integrating-with-amazon-seller.md).

# Integrating with Amazon Seller

Drivetrain connects to Amazon Seller Central through the Selling Partner API (SP-API). You create a private app in Seller Central, then enter three values in Drivetrain: the **LWA Client ID**, the **LWA Client Secret** and a **Refresh Token**.

## Before you start

* Access to Seller Central as the **Primary User**, or as a user with developer access. Only the Primary User can authorize the app (Step 5).

## Amazon Seller Central setup <a href="#amazon-seller-central-setup" id="amazon-seller-central-setup"></a>

### Step 1: Open Develop Apps

1. Log in to [Seller Central](https://sellercentral.amazon.com/).
2. In the top navigation bar, open **Partner Network**, then click **Develop Apps**.

![](https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-4861481aff52ee523de482486a585518a2347549%2Famazon-seller-01-develop-apps.png?alt=media)

### Step 2: Register as a private developer

You do this once per Seller Central account. If you already have a developer profile, skip to Step 4.

1. On **Develop Apps**, start the developer profile.
2. Fill in the details Amazon asks for:
   * Organization name
   * Organization home country
   * Primary contact name
   * Contact email
   * Contact phone
   * Data access
   * Roles
   * Primary business activity
   * Application / features
3. Accept the agreements and click **Register**.

### Step 3: Wait for Amazon's approval

Your profile shows **Under Review**. Approval takes from a few minutes to 3 business days, and Amazon emails the contact address when it's done. If Amazon emails you questions, reply within 5 days or the request is closed.

Once approved, the under-review banner disappears and **+ Add new app client** becomes available.

{% hint style="info" %}
**Haven't heard from Amazon?**

1. **Check the case first.** On **Develop Apps**, click **Click here** in the under-review banner. Amazon sometimes asks questions in the case without sending an email. Check your spam folder too.
2. **Contact Amazon Developer Support.** In Developer Central, open **Support / Contact us** and raise a case about "Developer profile registration pending". Include your Seller Central account name, the date you registered and the case ID if you have one. Amazon's Selling Partner API developer support team handles developer registration, not general Seller Support.
   {% endhint %}

### Step 4: Create the app

1. On **Develop Apps**, click **+ Add new app client**.

![](https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-b056f2067a72c2431556dba91a2ed5e60ab49465%2Famazon-seller-02-add-new-app-client.png?alt=media)

2. Enter:
   * **App name**: Drivetrain
   * **API type**: SP API
   * **Roles**: choose the roles that match the data you need. See Amazon's [Roles in the Selling Partner API](https://developer-docs.amazon/sp-api/docs/roles-in-the-selling-partner-api).

![](https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-deb0db60a6cbb873f213702201c020ca92d8002c%2Famazon-seller-03-create-your-app.png?alt=media)

3. Click **Save and exit**.

### Step 5: Authorize the app and copy the Refresh Token

1. On **Develop Apps**, find the **Drivetrain** app.
2. Click the arrow next to **Edit App**, then click **Authorize app**.
3. Choose your marketplace (for example, United States) and confirm.
4. Copy the **Refresh Token** and store it securely.

![](https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-19d617de660d6f9ecc517c5b0d3acfcece430cc3%2Famazon-seller-04-authorize-app.png?alt=media)

If you lose the Refresh Token, click **Authorize app** again to get a new one. Earlier tokens keep working.

### Step 6: Copy the LWA Client ID and Client Secret

1. On **Develop Apps**, click **View** under **LWA credentials** for the Drivetrain app.
2. Copy the **Client identifier**. This is your LWA Client ID, and it starts with `amzn1.application-oa2-client.`
3. Copy the **Client secret** and store it securely.

![](https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-a7e57ed43702afce49e03224d64d39fd699fe577%2Famazon-seller-05-lwa-credentials.png?alt=media)

## Connect in Drivetrain <a href="#connect-in-drivetrain" id="connect-in-drivetrain"></a>

### Step 7: Add Amazon Seller as a data source

1. In Drivetrain, click **Data** in the left menu.

![](https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-ae864201e23912257565910bda6f641bdff82ec0%2Famazon-seller-06-data-page.png?alt=media)

2. Click **+** to add a data source.

![](https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-e145172a3c1d0de3abcee8b3ad1ca9d104eff321%2Famazon-seller-07-add-data-source.png?alt=media)

3. In **Connect a data source**, go to **Others** and select **Amazon Seller**.

![](https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-924b23c7d2320ea59be31130a0943f5fbc370cf8%2Famazon-seller-08-connect-a-data-source.png?alt=media)

4. In **Connect your Amazon Seller account**, enter:
   * **LWA Client ID** (from Step 6)
   * **LWA Client Secret** (from Step 6)
   * **Refresh Token** (from Step 5)

![](https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-7673e13025fe786c0c91d6ae347fe4dfd5b9a604%2Famazon-seller-09-connect-your-account.png?alt=media)

5. Click **Submit**.

Your Amazon Seller Central account is now connected, and data starts flowing into Drivetrain automatically.

## What data comes in

Daily sales and traffic by SKU from the Selling Partner API, with product titles.

## Troubleshooting

| Problem                                                   | What to do                                                                                                                         |
| --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| No **Partner Network** or **Develop Apps** in the menu    | Your user doesn't have developer access. Ask the Primary User to grant it under **Manage permissions**, or have them do the setup. |
| **Authorize app** is missing or fails                     | Only the Primary User can authorize the app. Log in as that user.                                                                  |
| Lost the Refresh Token                                    | Click **Authorize app** again to get a new one. Earlier tokens keep working.                                                       |
| Drivetrain shows an authentication error after **Submit** | Copy all three values again with no extra spaces, and check that the app's roles are approved.                                     |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://integrations.drivetrain.ai/integration-guide/readme/others/integrating-with-amazon-seller.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
