Skip to main content
Connecting Amazon lists your Fluid products as offers on Amazon and imports Amazon orders into Fluid. Fluid lists each variant as an offer on the Amazon product page that matches its barcode, in one Amazon marketplace you choose. Setup takes a person in a browser for one step: approving Fluid’s access in Seller Central. Every other step is an API call.

Before you start

  • An Amazon Seller Central account, and a person who can sign in to it and approve apps.
  • The seller account isn’t connected to another Fluid company. One seller account connects to one company.
  • A Fluid API token for the company with company admin access: Company settings permission to connect, choose the marketplace and disconnect, and Products permission to list products. The examples use it as $FLUID_TOKEN.
  • A live company. A test store can’t connect a sales channel.

Steps

1

Start the connection

Pick the Seller Central region your account sells in:
The response’s url is the Seller Central consent link. Nothing changes in Fluid until someone approves it in the next step. Open the link yourself, or send it to the person who will approve it. The link works once and expires after 10 minutes; call authorize_url again for a new one.
2

Approve Fluid in Seller Central

Sign in to Seller Central and authorize Fluid.Amazon then sends the browser back to Fluid admin. The address ends in connect=ok when the connection saved, or connect=error&reason=... when it didn’t. Whatever the page shows, check the result:
The step is done when connection.status is connected. connection.display_name names the seller account, and connection.marketplace_id is the marketplace Fluid picked: the first one the seller sells in.
3

Choose the marketplace

Fluid lists products and imports orders in one marketplace. Skip this step if marketplace_id is already the one you want. Otherwise set it, for example to ATVPDKIKX0DER for amazon.com:
Fluid checks the marketplace with Amazon. It fails with 422 if the seller doesn’t sell in it.
4

List products

This changes live configuration: it creates offers on Amazon. Start with a few products if you haven’t sold on Amazon through Fluid before.
Fluid creates one listing per product and publishes it in the background. Products already live on Amazon are skipped, so sending the same IDs again is safe.
5

Check the listings

Repeat until no listing is draft. pending means Amazon accepted the offers and is processing them. The list is newest first, 25 per page; pass meta.pagination.next_cursor back as page[cursor] for the next page, or filter[product_id] to check one product.
6

Fix rejected products

A listing with status publish_failed wasn’t listed. last_error says why, for example a missing barcode or a product Amazon restricts for your account. Fix it, then retry the listing:
The step is done when no listing is publish_failed.

What each product needs

  • A marketplace chosen on the connection.
  • A SKU, a price and a barcode on every variant you list. Fluid uses the barcode to find the matching Amazon product, so the barcode has to match a product already in Amazon’s catalog.
  • A SKU that isn’t used by another listing on the connection.
  • Permission from Amazon to sell the product. Fluid checks Amazon’s listing restrictions before it creates any offer, and a restricted product fails with the restriction named in last_error.

Amazon orders

Fluid checks Amazon for new and updated orders on a schedule and imports each one as a Fluid order. To see what Fluid has imported, including orders it couldn’t import:
Filter with filter[ingestion_state], or filter[commerce_order_id] to find the Amazon order behind a Fluid order. An order whose SKU doesn’t match a listed Fluid variant isn’t imported; its row says why.

What the status means

Troubleshooting

  • authorize_url fails with 422. Fluid couldn’t start the connection. A test store gets this every time. Otherwise contact Fluid support.
  • The address after approving ends in connect=error. The reason says why. invalid_state means the link was used twice or expired: start again for a new one.
  • The reason is no_marketplaces. The seller account doesn’t sell in any marketplace yet. Finish setting up the account in Seller Central, then start again.
  • The reason is seller_already_connected. Another Fluid company already holds this seller account. Disconnect it there first.
  • Choosing the marketplace fails with 422. The seller doesn’t sell in that marketplace, or Fluid couldn’t reach Amazon to check. Use a marketplace from your Seller Central account.
  • A call fails with 404. The company has never connected Amazon. Run step 1.
  • A call fails with 403. Your token lacks the permission that call needs: Company settings for the connection, Products for products.

Remove products and disconnect

To take one product off Amazon, delete its listing. This deletes its offers on Amazon:
To disconnect:
Disconnecting leaves your offers on Amazon, but Fluid stops syncing products and importing orders until you connect again. Remove the listings first if you want the offers gone.

API reference