AMZ

Amazon SP-API Setup Guide

Connect your Amazon Seller Central account via Selling Partner API

Last updated June 2026 · Amazon SP-API (Orders v0, FBA Inventory v1, Catalog 2022-04-01)

What You Need

An Amazon Seller Central account (Individual or Professional)
A registered SP-API application in Seller Central (Developer Console)
An LWA (Login with Amazon) app with client ID, client secret, and refresh token
Your Marketplace ID (the Amazon marketplace you sell on)

Amazon SP-API uses Login with Amazon (LWA) OAuth — not simple API keys. You must register a developer application in Seller Central and complete a short authorization flow to obtain a refresh token. This guide walks through the entire process.

Step-by-Step Setup

Register as an SP-API developer In Seller Central, go to Apps & Services → Develop Apps. Click Add new app client or open the Developer Console if you already have one. Register your developer profile (company name, description, use case).
Create a new SP-API application In the Developer Console, click Add new app client. Set:
- App name: e.g. EcomCentral
- IAM ARN: create an IAM role in AWS with SP-API trust policy (see Amazon docs), or use the auto-created one if prompted
- API type: Selling Partner API
After creating, note the LWA Client ID and LWA Client Secret — these go into EcomCentral.
Authorize the app and get a refresh token The refresh token is obtained by the seller authorizing the app. There are two ways:

Option A — Self-authorization (if you own both the app and the seller account):
1. In Developer Console → your app → click Authorize
2. Select your seller account from the dropdown
3. Click Generate refresh token
4. Copy the Refresh Token — it starts with Atzr|...
Option B — OAuth authorization URL (for authorizing other sellers): Construct the authorization URL as described in the SP-API OAuth docs. After authorization, exchange the code for a refresh token via the LWA token endpoint.

Find your Marketplace ID Select the Marketplace ID matching the Amazon site you sell on:

Marketplace	ID	Endpoint region
Amazon.co.uk (UK)	`A1F83G8C2ARO7P`	eu-west-1
Amazon.de (Germany)	`A1PA6795UKMFR9`	eu-west-1
Amazon.fr (France)	`A13V1IB3VIYZZH`	eu-west-1
Amazon.it (Italy)	`APJ6JRA9NG5V4`	eu-west-1
Amazon.es (Spain)	`A1RKKUPIHCS9HS`	eu-west-1
Amazon.nl (Netherlands)	`A1805IZSGTT6HS`	eu-west-1
Amazon.com (US)	`ATVPDKIKX0DER`	us-east-1
Amazon.ca (Canada)	`A2EUQ1WTGCTBG2`	us-east-1
Amazon.com.mx (Mexico)	`A1AM78C64UM0Y8`	us-east-1
Amazon.co.jp (Japan)	`A1VC38T7YXB528`	us-west-2
Amazon.in (India)	`A21TJRUUN4KGV`	eu-west-1
Amazon.sa (Saudi Arabia)	`A17E79C6D8DWNP`	eu-west-1
Amazon.ae (UAE)	`A2VIGQ35RCS4UG`	eu-west-1

Add the connection in EcomCentral Go to Connections → Add Connection → Amazon SP-API and enter:

Field	Value
`client_id`	LWA Client ID from Developer Console (starts with `amzn1.application-oa2-client.`)
`client_secret`	LWA Client Secret
`refresh_token`	Refresh token from authorization step (starts with `Atzr\|`)
`marketplace_id`	Your marketplace ID from the table above
`region` (optional)	SP-API region: `eu-west-1` (EU), `us-east-1` (NA), `us-west-2` (FE). Defaults to `eu-west-1`.
`endpoint` (optional)	Override the SP-API base URL. Leave blank for the default derived from region.

Then click Save and use ⚡ Test to verify the connection shows your marketplace participations.

What EcomCentral Can Do with Amazon SP-API

Feature	Status	Notes
Connection test	Supported	Returns marketplace participations (name + count)
View orders (last 90 days)	Supported	Orders API v0 — Unshipped, PartiallyShipped, Shipped, Pending
View order detail + line items + address	Supported	Address requires PII data access role (see below)
Confirm shipment (add tracking)	Supported	Only for Unshipped / PartiallyShipped orders
FBA inventory levels	Supported	FBA Inventory v1 — shows fulfillable, inbound qty per SKU
Catalog search / ASIN lookup	Supported	Catalog Items 2022-04-01 API
Product list	N/A	SP-API has no bulk catalog-list endpoint — use FBA Inventory or Catalog Search
Stock update (FBA)	Not supported	FBA inventory is Amazon-managed and cannot be set via API
Stock update (FBM)	Not supported	Requires Feeds API (JSON_LISTINGS_FEED) — not currently implemented

PII Data Access (Shipping Addresses)

Shipping addresses contain PII (Personally Identifiable Information) and require a separate data access role in Seller Central.

In Seller Central → Apps & Services → Develop Apps
Click your app → Edit
Under Data access roles, enable Buyer info and/or Shipping & tax
Submit for review if required (Amazon may approve automatically for self-authorized apps)

ℹ️ If address data is unavailable, EcomCentral shows the order detail without the address section and displays an explanatory note — it does not throw an error.

Amazon Order Statuses

Status	Meaning	Action Available
Pending	Order placed, not yet confirmed by Amazon	—
PendingAvailability	Pre-order or availability pending	—
Unshipped	Ready to ship — all items unshipped	Confirm Shipment
PartiallyShipped	Some items shipped, others pending	Confirm Shipment
Shipped	All items confirmed shipped	—
InvoiceUnshipped	Invoice generated but not yet shipped (EU B2B)	—
Canceled	Order cancelled by buyer or Amazon	—
Unfulfillable	Cannot be fulfilled (e.g. out of stock FBA)	—

Confirming Shipments

When you click Confirm Shipment in EcomCentral:

EcomCentral fetches all order items for the order to obtain their OrderItemId values
All items are included in the shipment package payload
Amazon receives the carrier code, tracking number, and ship date
The order status moves from Unshipped → Shipped
Amazon notifies the buyer with the tracking information

⚠️ Carrier codes: Amazon requires specific carrier codes in most cases. Common values: UPS, USPS, FedEx, DHL, DPD, Hermes, Royal Mail, DHL Express, TNT. If Amazon does not recognize the carrier, the shipment may be rejected. Use Other as a fallback if needed.

Troubleshooting

✕ LWA token exchange failed

One of client_id, client_secret, or refresh_token is wrong. Double-check all three values. The refresh token starts with Atzr|.

✕ SP-API error 403: Access to requested resource is denied

The SP-API app does not have the required permission role. In Developer Console, edit your app and enable the missing role: Orders, FBA Inventory, Catalog Items, Shipment Confirmation, or Buyer Info.

✕ SP-API error 401: Unauthorized

The refresh token has been revoked or the authorization expired. Re-authorize the app in Seller Central and generate a new refresh token.

✕ "No open fulfillment orders" / cannot confirm shipment

Only Unshipped and PartiallyShipped orders can receive shipment confirmation. Check the order status — if it is already Shipped or Canceled, no further action is possible.

✕ FBA Inventory returns empty

The FBA Inventory role (FBA Inventory) may not be enabled, or there is no active FBA inventory for the configured marketplace. Check the marketplace ID matches where you have FBA stock.

Address shows "not available"

Buyer PII data roles are not enabled for your SP-API app. See the PII Data Access section above.

EcomCentral · Amazon Selling Partner API · Official SP-API Docs