Amazon Seller Central Connection

Connects your agent to Amazon Seller Central via the Selling Partner API (SP-API). Read orders, listings, inventory, FBA shipment data, advertising metrics, and account health. Write operations require confirmation.

Authentication

OAuth2 via Amazon Selling Partner API.

• client_id — SP-API app client ID
• client_secret — SP-API app client secret
• refresh_token — LWA refresh token
• marketplace_id — Target marketplace (e.g., ATVPDKIKX0DER for US)

Endpoints

Orders

• GET /orders/v0/orders — List orders with date, status, fulfillment filters
• GET /orders/v0/orders/{orderId} — Get order detail with items and shipping

Listings

• GET /listings/2021-08-01/items/{sellerId}/{sku} — Get listing detail
• PATCH /listings/2021-08-01/items/{sellerId}/{sku} — Update listing (confirmation)

Inventory

• GET /fba/inventory/v1/summaries — Get FBA inventory levels by SKU
• GET /inventories/v1/items — Get merchant-fulfilled inventory

FBA

• GET /fba/inbound/v0/shipments — List FBA shipment plans
• GET /fba/inbound/v0/shipments/{shipmentId}/items — Get shipment items

Advertising

• GET /v2/sp/campaigns — List Sponsored Products campaigns
• GET /v2/sp/reports — Get advertising performance reports

Account Health

• GET /sellers/v1/marketplaceParticipations — Get account status and health

Rules

• Rate limit: varies by API section (Orders: 1 request/second, Inventory: 2/second)
• Listing updates require confirmation
• The agent respects marketplace-specific formatting (currency, date format)
• FBA inventory data may have 24-hour lag — the agent notes data freshness
• Advertising data uses a 72-hour attribution window