# Amazon Seller Partner API (prebuilt connector)

## Description

The [Amazon Seller Partner API ](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/patchworks-connectors/amazon-seller-partner-api-prebuilt-connector)enables sellers to access and manage data from their Amazon business, including listings, orders, payments, and reports.

## API documentation

API documentation for the *Amazon Seller API* (used to build this connector) can be found via the link below:

{% embed url="<https://developer-docs.amazon.com/sp-api/docs/welcome>" %}

## Authentication&#x20;

When adding connector instances for the *Amazon Seller API*, the following authentication methods are supported:

* [Refresh token authentication](#token-authentication)

### Refresh token authentication

{% hint style="info" %}
To obtain the required credentials, you must complete Amazon's self-authorisation process, authorising Patchworks to access your data. The steps are detailed in Amazon's documentation: [Authorize Private Applications](https://developer-docs.amazon.com/sp-api/docs/self-authorization).
{% endhint %}

When a user chooses to [add a connector instance](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance) using **token** authentication, the credentials below are prompted:

<table><thead><tr><th width="193">Credential</th><th data-type="checkbox">Required?</th><th>Notes</th></tr></thead><tbody><tr><td><code>client id</code></td><td>true</td><td>Your application's <code>client ID</code> is available in <em>Seller Central</em>, <em>Vendor Central</em>, or the <em>Solution Provider Portal</em>. Please see Amazon's documentation: <a href="https://developer-docs.amazon.com/sp-api/docs/viewing-your-application-information-and-credentials">View your Application Information and Credentials</a>.. </td></tr><tr><td><code>client secret</code></td><td>true</td><td>As per <code>client id</code>, above.</td></tr><tr><td><code>SP-API endpoint</code></td><td>true</td><td>API requests must be directed to the correct endpoint based on your target marketplace. Please see Amazon's documentation: <a href="https://developer-docs.amazon.com/sp-api/docs/sp-api-endpoints">SP-API endpoints</a>.</td></tr><tr><td><code>refresh token</code></td><td>true</td><td>The refresh token you received and stored during the authorisation process.</td></tr></tbody></table>