Only a Global Admin can open Sales Channels. Amazon works differently from eBay: there is no sign-in popup. You register your own Selling Partner API (SP-API) application in Amazon Seller Central and give Sugibana Flow its credentials. This is called "bring your own app".
You need an active Amazon seller account, and you are the person who can register apps in it.
Connecting Amazon: 1. Register your app (in Seller Central; copy client ID and secret) → 2. Authorise it (copy the refresh token, shown once) → 3. Configure a region (Seller ID and Refresh token) → 4. Account credentials (client ID and secret, then Status ACTIVE) → 5. Turn on marketplaces (Orders and Stock).
What do I need from Amazon first?
Write down four values. In Seller Central:
- Go to Apps & Services → Develop Apps and create a new SP-API developer application. Copy its LWA Client ID and LWA Client Secret.
- Authorise the app in Seller Central to generate the Refresh token. It is displayed once; copy it at once, it cannot be shown again.
- Find your Seller ID (also called Merchant ID) in Seller Central settings.
Amazon splits the SP-API into three regions: Europe (EU), North America (NA) and Far East (FE). Pick the region where you sell. The Seller ID and Refresh token belong to one region. The client ID and secret belong to your app, so they are the same for all three.
How do I open Amazon?
Click Admin in the sidebar (the Admin page), then the Sales Channels card, then Amazon in the list of channels. The Amazon drawer opens on the right. While Amazon is Not connected, it shows Ways to connect with Your own Amazon developer app and a Connect button. Click Connect to open the region cards. Each region card shows Not configured, Incomplete or Ready.
Screenshot: The Amazon drawer while Amazon is Not connected: the text Ways to connect with one option, Your own Amazon developer app, its You will need line (seller ID, refresh token, client ID and secret) and a green Connect button.
How do I add my first region?
If Is this your first region?: Save credentials (saved INACTIVE; Flow asks for the app credentials) → Account credentials (enter client ID and secret) → Set Status ACTIVE (save the region again). Otherwise: Save credentials (client ID and secret are reused; ACTIVE straight away).
- In the Amazon drawer, click Configure on the region card (for example Europe (EU)).
- Fill in Seller ID and Refresh token, leave Status ACTIVE and click Save credentials.
- First region only: Flow says "Region saved. Enter your Amazon app credentials above, then set this region to ACTIVE." Nothing is wrong. Amazon still reads Not connected and the guided form stays open until the client ID, secret and a refresh token are all stored. Disconnect is already available below it if you want to start over.
Screenshot: The Amazon drawer mid-setup after the first region was saved: Account credentials with LWA Client ID and LWA Client Secret, and the Europe (EU) form marked Incomplete with the note Region saved. Enter your Amazon app credentials above, then set this region to ACTIVE.
How do I enter the client ID and secret?
- In the Account credentials box of the Amazon drawer (above the region cards while Amazon is Not connected, in the Account section once it is connected), type LWA Client ID and LWA Client Secret.
- Answer Was this secret rotated today? and check Expires on; see renewing your LWA client secret.
- Click Save account credentials. A green note lists the regions updated.
One save covers every region you have set up, so no region is left on an old secret. A field marked "stored — leave blank to keep" keeps its value when left empty. Secrets and tokens are encrypted and never shown again.
How do I switch the region on?
The region badge shows Ready as soon as all four values (Seller ID, Client ID, Client Secret, Refresh token) are stored. That is not the same as ACTIVE: a region still saved as INACTIVE does nothing.
- In the Amazon drawer, use the form that is still open. Once Amazon is connected, open the Channel-specific · Amazon section and click Edit on the region card.
- Set Status to ACTIVE and click Save credentials. Leave the refresh token blank to keep the stored one.
Incomplete means one of the four values is missing. To add another region where you sell, click Configure on its card and enter its Seller ID and Refresh token.
How do I turn on orders and stock?
Once Amazon is connected, the drawer's Features section also holds the Ship-confirm switch ("Ship-confirm: send tracking & mark shipped on Amazon"; it stays off and reads "Coming soon — Sugibana switches this on per channel." until Sugibana switches it on for this channel) and Access health: OK · checked …, Not verified or Access lost: … per feature, the last with an Open the case link. Status and Features start open; Account, Channel-specific · Amazon and Danger zone start closed, so click a section to open it.
Screenshot: The connected Amazon drawer with the Features section open: Photo pull and Order import switches, the Ship-confirm switch reading Coming soon, and Access health listing Order import, Stock push and Ship-confirm as OK with a check time. Account, Channel-specific · Amazon and Danger zone are collapsed below.
Once a region is Ready and ACTIVE, its card lists Marketplaces such as Amazon.de, with an Orders and a Stock column.
- Orders: include the marketplace in order polling.
- Stock: push quantity changes to that marketplace.
They are independent, per marketplace. Greyed-out rows are marketplaces your seller account is not enrolled in; enrol in Seller Central first. The card also has Order sync and Stock push switches for the whole region. Orders are checked on your sync interval and then appear in Orders.
How do I know it works?
Click Refresh Amazon at the top of the Channel-specific · Amazon section (click the section to open it) of the Amazon drawer. It re-reads your marketplace enrolment from Seller Central for all regions and changes nothing. A failure shows as "Amazon check failed: …".
If the button reads "Setup window active" or "Available in …", it is temporarily locked while Sugibana Flow finishes setting up your first channel. Wait for the countdown.
It does not connect. What now?
- Region will not save as ACTIVE: "A refresh token is required to activate an Amazon region". Enter the Refresh token.
- Save account credentials is greyed out: the client ID is empty, or you typed a secret and have not answered the rotation question.
- Errors after a secret was changed in Seller Central: enter the new secret in Account credentials (see renewing your LWA client secret).
- Client ID or secret rejected: check they match Seller Central exactly, and that the Seller ID and Refresh token are for the same region.
- Marketplace missing from the list: your seller account is not enrolled there; enrol in Seller Central, then click Refresh Amazon.
How do I disconnect Amazon?
Click Disconnect in the Danger zone section of the Amazon drawer, then Yes, disconnect. Orders and stock stop syncing, and your stored app credentials (client ID, secret and refresh token) are deleted. To reconnect you enter all three again; the Seller ID stays. Your products, orders and history stay, and you can reconnect any time. Your listings on Amazon stay live with their last quantities; end them there if you no longer want to sell, or they can oversell.
For everything else about channel connections, see Adding a sales channel and keeping its connection healthy.