Amazon Seller Setup Guide

Time: 15 minutes | Difficulty: Advanced | Market: E-Commerce Mode: Full automation (conditional) | API: Selling Partner API (SP-API) | Docs: developer-docs.amazon.com/sp-api

This guide wires an Amazon seller bot to the Selling Partner API using the botwir3 runtime. Configure API credentials, connect to seller-side inventory and pricing operations, and run automated repricing strategies locally.

⚠ Access requirements

Amazon Selling Partner API access requires seller account registration and developer application approval. This may include:

• A registered Amazon Seller Central account (Individual or Professional)
• Developer application registration via Seller Central → Develop Apps
• Approval of the application (timeline varies)
• LWA (Login with Amazon) OAuth2 credentials
• Compliance with the SP-API Acceptable Use Policy

⚠ Seller-side only. Amazon SP-API supports seller operations: inventory management, pricing, order fulfillment, and product listing. Automated order placement as a buyer is explicitly prohibited under Amazon's terms. This guide covers seller-side automation only.

Amazon SP-API Developer Docs | SP-API Acceptable Use Policy

The user is responsible for obtaining appropriate access and complying with all platform terms.

Before you start

Verify that automated operation is permitted under Amazon's current terms of service before deploying. botwir3 provides tools for building structured automation. The user is responsible for compliance with the platform's terms and all applicable regulations.

Amazon Services Business Solutions Agreement | Last verified: May 2026

What you need

• An Amazon Seller Central account (Professional plan for API access)
• SP-API developer application approved
• LWA client ID and client secret
• Refresh token from the OAuth2 authorization flow
• The botwir3 runtime downloaded and unzipped
• A strategy config file from the builder

Step 1: Create API credentials

1. Log in to Seller Central
2. Navigate to Apps & Services → Develop Apps
3. Register a new application
4. Complete the OAuth2 authorization flow to obtain a refresh token
5. Note the LWA Client ID, Client Secret, and Refresh Token

Permissions required: Pricing, Inventory, Product Listing (scoped per application). Permissions to disable: Order placement (buyer-side) — not available. The SP-API for sellers does not support purchasing as a buyer.

🔒 Security. SP-API uses OAuth2 with rotating access tokens. Refresh tokens are long-lived but scoped to the authorized seller account. Credentials are stored in a local config file and are not transmitted to botwir3 or any third party. botwir3 never sees, stores, or has access to platform credentials.

Step 2: Configure the adapter

Create adapter.json in the bot directory:

{
  "adapter": "amazon",
  "credentials": {
    "client_id": "paste-lwa-client-id-here",
    "client_secret": "paste-lwa-client-secret-here",
    "refresh_token": "paste-refresh-token-here",
    "marketplace_id": "ATVPDKIKX0DER"
  },
  "mode": "seller",
  "environment": "live",
  "rate_limit_ms": 1000
}

marketplace_id: ATVPDKIKX0DER (US), A1F83G8C2ARO7P (UK), A1PA6795UKMFR9 (DE). See the SP-API marketplace reference.

API keys are stored in a local config file on the machine running the bot. They are not transmitted to botwir3 or any third party. botwir3 never sees, stores, or has access to platform credentials.

Step 3: Test the connection

botwir3 test --adapter amazon

Expected output:

[botwir3] Adapter: amazon
[botwir3] Connection: OK
[botwir3] Permissions: pricing, inventory, listings
[botwir3] Marketplace: US (ATVPDKIKX0DER)
[botwir3] Rate limit: per SP-API documentation

Step 4: Start the bot

botwir3 start --config my-strategy.json

The runtime loads the strategy, computes the spec hash, connects to the Amazon SP-API via the local OAuth2 credentials, and begins evaluating signals. The gate function compares proposed actions against the configured spec. The user is responsible for monitoring the bot and verifying execution outcomes.

Rate limits and considerations

Common Amazon seller bot configurations include automated repricing (adjusting listing prices to compete for the Buy Box), inventory level monitoring with restock alerts, and competitive price tracking across product categories. All actions and decisions are recorded in the local ledger.

Troubleshooting

Related guides

• Walmart Marketplace Setup Guide — e-commerce, seller-side automation
• Shopify Setup Guide — e-commerce, seller-side automation
• TCGPlayer Setup Guide — collectibles, seller-side automation

One bot. $129. No subscription. No $749/mo platform. → Build for Amazon