Learn how to publish AI Tools that connect to buyers' Amazon Seller Central accounts via the Selling Partner API (SP-API).
This integration lets your AI Agent automation read product listings, fetch order metrics, analyze catalog data, manage feeds, and update A+ content. SellerShorts makes SP-API calls on behalf of buyers through your AI Agent.
Security & Privacy: All API calls are made through SellerShorts' secure infrastructure. Sellers never have direct access to buyer Amazon Seller Central accounts.
Access is scoped to the specific order and capabilities defined for the AI Tool. All tokens are encrypted at rest (AES-256-GCM) and signed with AWS SigV4 on every SP-API call.
๐ Token & Credential Handling
job_token.This architecture complies with Amazon's Data Protection Policy (DPP) and Acceptable Use Policy (AUP).
When you publish an AI Tool that requires Amazon Seller Central access, buyers connect their own Amazon Seller Central accounts when they run your AI Tool.
Your AI Agent automation receives a secure job_token that allows it to request SP-API calls through SellerShorts on the buyer's behalf.
All 10 available capabilities are automatically enabled when you select Amazon Seller Central. No additional configuration needed.
job_token.job_token to call SellerShorts โ Amazon SP-API.listings.get, listings.update, listings.update_images) are available on opt-in via the wizard's "Post to Amazon (Optional)" section.job_token in the payloadโ ๏ธ Sellers must be the PRIMARY user
Per Amazon's official policy, the seller must be logged into Amazon Seller Central as the PRIMARY user (account owner) with the registered primary email address before they authorize your AI Tool. Secondary users, even those with admin privileges, cannot complete the authorization.
If a buyer sees a blank consent page after picking a marketplace, this is the most common reason. Instruct them to log out of Seller Central, log back in as the primary user, then retry the connection.
๐ Amazon-approved scope (production-tier SP-API app: sellershorts_prod)
SellerShorts is registered with Amazon as a Solution Provider for the Selling Partner API. The approval scope is fixed and constrains what your AI Tool can do via the broker. Please design within these limits:
Approved business entity:
SP-API roles requested at OAuth time:
listings.upload_feed, listings.a_plus_generate, listings.get, listings.update, listings.update_images, catalog.search, products.list, products.detail). Per Amazon's role description: "Create and manage product listings, including A+ content."account_health.fetch, orders.summary, parts of analytics.fetch, connect.status, messaging.request_review). Per Amazon: "View information about the Amazon Selling Partner account and performance."analytics.fetch; requires the buyer's Brand Registry enrollment in addition to the role). Per Amazon: "Access your sales and inventory data to manage your Amazon Retail business."NOT requested (intentionally):
finance.summary capability is therefore not exposed to creators today. This reduces the platform's Data Protection obligation surface (financial events include order identifiers that are PII-adjacent). If a future tool concept needs financial data, SellerShorts will roll out scope-string + opt-in support deliberately. Per Amazon: "Produce account and financial statements. Does not include information required to generate tax invoices."orders.summary return aggregated metrics only.If your AI Tool concept requires Inventory tracking, financial-event-level data, raw order PII, or non-Seller (Vendor / Amazon Business) accounts, the SP-API integration is not the right fit today. Reach out to support if your use case is borderline.
๐ Amazon references: SP-API Roles overview ยท Role-to-operation mappings ยท SP-API Policies and Agreements (DPP + AUP)
๐ Your AI Tool must produce Amazon-policy-compliant content and actions
The SellerShorts broker forwards your AI Tool's requests to Amazon's API. Amazon's content, advertising, and communication policies apply to every request. The buyer (account holder) is ultimately responsible to Amazon for what is posted on their account, but as the AI Tool creator you are responsible for generating output that helps the buyer stay compliant.
Per-capability policy notes are shown in the capability sections below. Common rules that apply across capabilities:
analytics.fetch (capability #7).listings.update (#9).listings.update_images (#10).messaging.request_review (#13).confirm.summary and confirm.diff_preview fields shown to the buyer must accurately describe what the broker will do. Misleading previews are grounds for tool de-listing.orders.summary, etc.) return aggregated metrics only. Your tool must not attempt to derive or infer buyer PII from the aggregate.Amazon retains the right to take action against any seller whose listings, images, content, or messages violate policy, regardless of whether the violation came from a manual edit or an AI Tool. Build defensively.
๐ Amazon authoritative source: SP-API Policies and Agreements (Data Protection Policy, Acceptable Use Policy, Solution Provider Agreement).
In the Inputs step of the AI Tool submission wizard, expand the "Authentication & Access Requirements" section.
You'll see a card for "Amazon Seller Central" with the description that summarizes the broker's SP-API access (products, listings, catalog search, order aggregates, analytics, Solicitations, and Account Health). Inventory and Order Tracking, financial events, and PII are intentionally out of scope (see the approval-scope box above).
Click the Amazon Seller Central card to select it. When selected, the card shows a green checkmark and an "Enabled" status badge.
Capabilities are permissions that define what your AI Agent can do with a buyer's Amazon Seller Central account.
When you select Amazon Seller Central, 11 capabilities are automatically enabled for your AI Agent (no configuration needed). An additional 3 Listings Items API capabilities are available on demand: listings.get (GET, reads a single listing's full attribute set), listings.update (PATCH write), and listings.update_images (PATCH write). You opt into them per-tool in the wizard's "Post to Amazon (Optional)" section, and admin reviews each tool's declared write actions before approval. Together these cover product listings (read + PATCH writes), catalog search, feed submission, order summary aggregates, analytics (Brand Analytics SQP + Sales/Traffic Reports), A+ content generation, Amazon's Request-a-Review flow, and Seller Performance / Account Health reports.
Verify the buyer's Amazon Seller Central connection is active and check marketplace participations.
/sellers/v1/marketplaceParticipationsFetch a list of products from the buyer's catalog.
Get detailed information about a specific product (ASIN, attributes, images, etc.).
Search the Amazon catalog by keywords to find competing or similar products.
GET /catalog/2022-04-01/items. See the Catalog Items API v2022-04-01 reference.Check the status of submitted feeds (listings, inventory, pricing).
Aggregated order metrics (total orders, units, revenue). No buyer PII included.
Fetch aggregated analytics data using async Reports API workflow (create request, then poll status, then download report).
insights_summary (default), sales_traffic (Sales & Traffic Reports), brand_analytics_search_terms, brand_analytics_market_basket, brand_analytics_item_comparison, brand_analytics_search_query_performance (Brand Analytics SQP, added Phase 5)Retrieve a single product listing (attributes, images, descriptions, A+ Content references) by SKU.
GET /listings/2021-08-01/items/{sellerId}/{sku}Push listing patches (titles, bullets, descriptions, attribute changes) to a buyer's listing via PATCH.
PATCH /listings/2021-08-01/items/{sellerId}/{sku}Show "Apply to Amazon" button after tool runs toggle ON (defaults to ON when you check a write verb).โ ๏ธ Amazon listing content policy (your AI Tool must respect):
issues array of the response with severity ERROR or WARNING.Your AI Tool generates the content; the buyer's account bears the policy responsibility. Repeated violations can lead to listing suppression or account-level actions against the buyer.
๐ Amazon references: Listings Items API v2021-08-01 reference
Push image patches (main image, variant images, additional images) to a buyer's listing.
โ ๏ธ Amazon image policy (your AI Tool must respect):
Amazon's image-fetch step runs server-side; non-compliant images may be silently ignored or trigger account-level warnings to the buyer.
๐ Amazon references: Product image guide (Seller Central) ยท Listings Items API reference
Submit listing updates or creations to Amazon via Feeds API (bulk path).
listings.update (PATCH) which is faster and simpler.feed_type parameter is a free string (any Amazon-supported feed type can be passed). For Listings, Amazon has deprecated the legacy XML/flat-file types; only JSON_LISTINGS_FEED is active for new Listings submissions (verified 2026-05-28 against developer-docs.amazon.com/sp-api/docs/feed-type-values). Other feed categories (FBA, Orders, Easy Ship, Invoicing) still accept their existing feed type values.text/xml (default, backward compat for non-Listings categories), text/tab-separated-values, text/plain, and application/json (required for JSON_LISTINGS_FEED, added Phase 6 Item 9).POST_INVENTORY_AVAILABILITY_DATA XML inventory feed on July 31, 2025. Use Listings Items PATCH (listings.update) for inventory mutations instead.Create or update A+ Content modules (Enhanced Brand Content).
POST /aplus/2020-11-01/contentDocumentsโ ๏ธ Amazon A+ Content policy constraints:
Your AI Tool is responsible for generating content that respects these rules. Amazon's review step is the final gate; non-compliant content will not go live.
๐ Amazon references: A+ Content API use case guide ยท Amazon Brand Registry eligibility
Trigger Amazon's official "Request a Review" email flow on a buyer order (Solicitations API). This is the Amazon-sanctioned mechanism for asking buyers to leave a review.
POST /solicitations/v1/orders/{amazonOrderId}/solicitations/productReviewAndSellerFeedbackamazonOrderId path parameter is Amazon's order ID (e.g., 123-1234567-1234567), not SellerShorts' internal order ID.โ ๏ธ Amazon policy constraints (sellers/buyers responsible for following):
If Amazon rejects the solicitation for any of these reasons, the broker returns the error response from Amazon. The buyer (account holder) is ultimately responsible for compliance.
๐ Amazon references: Solicitations API use case guide ยท Solicitations v1 reference
Fetch the seller's Account Health / Seller Performance report via async Reports API workflow.
reportType: GET_V2_SELLER_PERFORMANCE_REPORT (async workflow: create request, then poll status, then download report). Roles required by Amazon: Selling Partner Insights. Availability: Sellers only. Requested-only (cannot be scheduled).(Capabilities 8-10 are the Listings Items API verbs (one GET read and two PATCH writes) added in the 2026-05-27 listings PATCH pass. Capabilities 13-14 (Solicitations and Account Health Reports) were added in the 2026-05-28 Phase 1-6 capability gap closure. They all reuse the existing Amazon Seller Central OAuth connection, so no new connection type was introduced. The broker requests three SP-API roles at OAuth time: Product Listing, Selling Partner Insights, and Brand Analytics. If a future verb requires a different role, the seller would need to re-authorize.)
All Amazon Seller Central SP-API calls go through SellerShorts' capabilities API endpoint:
Base URL: https://sellershorts.com/api/capabilities
To make SP-API calls, send requests to the capabilities API endpoint with the job_token in the Authorization header:
POST https://sellershorts.com/api/capabilities
Authorization: Bearer {job_token}
Content-Type: application/json
{
"capability": "products.list",
"provider": "amazon",
"params": {
"marketplace_id": "ATVPDKIKX0DER",
"page_size": 20
}
}POST https://sellershorts.com/api/capabilities
Authorization: Bearer {job_token}
Content-Type: application/json
{
"capability": "connect.status",
"provider": "amazon",
"params": {}
}POST https://sellershorts.com/api/capabilities
Authorization: Bearer {job_token}
Content-Type: application/json
{
"capability": "catalog.search",
"provider": "amazon",
"params": {
"keywords": "wireless headphones",
"marketplace_id": "ATVPDKIKX0DER",
"page_size": 20
}
}POST https://sellershorts.com/api/capabilities
Authorization: Bearer {job_token}
Content-Type: application/json
{
"capability": "orders.summary",
"provider": "amazon",
"params": {
"marketplace_id": "ATVPDKIKX0DER",
"start_date": "2026-01-01T00:00:00Z",
"end_date": "2026-01-31T23:59:59Z",
"granularity": "DAY"
}
}When a buyer authorizes Amazon Seller Central, SellerShorts saves one connection per marketplace their account participates in. For example, a North American seller may have 3 connections (US, Canada, Mexico) under a single authorization.
To target a specific marketplace in your API calls, pass marketplace_id in the params. SellerShorts will route the request to the correct regional endpoint automatically (NA, EU, or FE).
| Region | Country | Marketplace ID |
|---|---|---|
| NA | ๐บ๐ธ United States | ATVPDKIKX0DER |
| NA | ๐จ๐ฆ Canada | A2EUQ1WTGCTBG2 |
| NA | ๐ฒ๐ฝ Mexico | A1AM78C64UM0Y8 |
| NA | ๐ง๐ท Brazil | A2Q3Y263D00KWC |
| EU | ๐ฌ๐ง United Kingdom | A1F83G8C2ARO7P |
| EU | ๐ฉ๐ช Germany | A1PA6795UKMFR9 |
| EU | ๐ซ๐ท France | A13V1IB3VIYZZH |
| EU | ๐ฎ๐น Italy | APJ6JRA9NG5V4 |
| EU | ๐ช๐ธ Spain | A1RKKUPIHCS9HS |
| EU | ๐ณ๐ฑ Netherlands | A1805IZSGTT6HS |
| EU | ๐ง๐ช Belgium | AMEN7PMS3EDWL |
| EU | ๐ธ๐ช Sweden | A2NODRKZP88ZB9 |
| EU | ๐ต๐ฑ Poland | A1C3SOZRARQ6R3 |
| EU | ๐ฎ๐ช Ireland | A28R8C7NBKEWEA |
| EU | ๐ช๐ฌ Egypt | ARBP9OOSHTCHU |
| EU | ๐ฆ๐ช UAE | A2VIGQ35RCS4UG |
| EU | ๐ธ๐ฆ Saudi Arabia | A17E79C6D8DWNP |
| EU | ๐น๐ท Turkey | A33AVAJ2PDY3EV |
| EU | ๐ฟ๐ฆ South Africa | AE08WJ6YKNBMC |
| EU | ๐ฎ๐ณ India | A21TJRUUN4KGV |
| FE | ๐ฏ๐ต Japan | A1VC38T7YXB528 |
| FE | ๐ธ๐ฌ Singapore | A19VAU5U5O7RUS |
| FE | ๐ฆ๐บ Australia | A39IBJ37TRP1C6 |
All possible error codes returned by the capabilities API for Amazon Seller Central:
INVALID_TOKEN: job_token missing or invalidCAPABILITY_NOT_ALLOWED: capability not enabled for this AI ToolTOKEN_EXPIRED: buyer's Amazon connection has been revoked, ask them to reconnectNO_CONNECTION: buyer has not connected Amazon Seller Central yetSP_API_ERROR: Amazon's SP-API returned an errorRATE_LIMIT: too many requests, retry with backoffINVALID_REQUEST: request body is invalidORDER_NOT_FOUND: order ID in token does not existINTERNAL_ERROR: unexpected server error11 standard capabilities are automatically enabled when you select Amazon Seller Central, plus 3 additional Listings Items API verbs (one GET read and two PATCH writes) available on opt-in via the wizard. While you have access to all capabilities your tool declares, design your AI Agent to only use the capabilities it actually needs. This follows the principle of least privilege and makes your AI Tool's behavior clearer to buyers.
Connect your own Amazon Seller Central account during development. Verify that:
Be explicit in your AI Tool description about:
No. You don't need an Amazon Seller Central account to publish an AI Tool. Buyers connect their own accounts when they run your AI Tool.
Yes. You can connect your own Amazon Seller Central account to test the integration end-to-end before publishing.
They cannot run your AI Tool. The connection step is required, and they'll see instructions to authorize Amazon Seller Central if they haven't yet.
All 23 official Amazon marketplaces are supported across North America (US, Canada, Mexico, Brazil), Europe (UK, Germany, France, Italy, Spain, Netherlands, Belgium, Sweden, Poland, Ireland, Egypt, UAE, Saudi Arabia, Turkey, South Africa, India), and Far East (Japan, Singapore, Australia). Sellers connect once and access is granted to every marketplace their account participates in.
When you select Amazon Seller Central, 11 SP-API capabilities are automatically enabled: connect.status, products.list, products.detail, catalog.search, feeds.status, orders.summary, analytics.fetch (Brand Analytics SQP + Sales/Traffic Reports), listings.upload_feed, listings.a_plus_generate, messaging.request_review (Solicitations API), and account_health.fetch (Seller Performance Reports). An additional 3 Listings Items API capabilities (listings.get, listings.update, listings.update_images) are available on opt-in via the wizard's "Post to Amazon (Optional)" section. Note: financial data (Finances API) is intentionally out of scope today; no current tool requires it.
Currently, edits to an approved AI Tool are not automatically re-reviewed. If you change capabilities, submit your AI Tool for admin re-review to stay aligned with platform policy.
Per Amazon's policy, the seller must be logged into Amazon Seller Central as the PRIMARY user (account owner) before authorizing your AI Tool. Secondary users (even admins) cannot complete the authorization.
No. Once a buyer connects, the connection persists across orders. They only need to reconnect if they manually disconnect or if their tokens are revoked by Amazon.
Need help? See the Inputs guide, the Callback guide, or contact support.