Rotating, renewing, refreshing, changing and updating your Amazon client secret all mean the same thing here. People also call it "Amazon keys", "Amazon API keys", "SP-API credentials" or "the Amazon secret".
Why does my Amazon client secret expire?
Amazon requires the Login with Amazon (LWA) client secret of every Selling Partner API application to be replaced every 180 days, whether or not you are selling. It is Amazon's rule; it cannot be switched off or extended.
Once it lapses, Amazon refuses to issue the access tokens Flow needs, and everything Amazon stops at once:
- new Amazon orders stop being imported;
- stock levels stop being sent, so Amazon keeps showing its last number;
- the Amazon connection shows an error and validating it fails.
Nothing is lost and it all resumes with a new secret, but until then you can oversell.
How much warning do I get?
Warnings before the deadline: 1. Amazon warns (about 30 days ahead, Seller Central banner and maybe email) → 2. Flow warns (20 days ahead, only if Expires on is filled in) → 3. Deadline passes (Flow banner turns red).
- Amazon's banner reads "Action Required: Rotate LWA Credentials".
- Flow's banner sits across the top of your dashboard and cannot be dismissed.
- The date has to be typed in once because no Amazon API tells us when your secret expires. Entering it when you paste a new secret arms the next reminder.
How do I renew the secret?
Renewing the secret: 1. Open Develop Apps (Seller Central) → 2. Click View (LWA credentials column) → 3. Note the deadline (Rotation Deadline) → 4. Generate new secret (shown once, copy it) → 5. Paste it in Flow (Account credentials) → 6. Check Expires on.
Where do I find the secret in Amazon?
You do this in Amazon's developer portal, not in Flow.
- Sign in to Amazon Seller Central.
- Go to Apps and Services → Develop Apps (also called the Solution Provider Portal).
- Find the application you use with Flow. If Amazon flagged it, a warning triangle sits next to it in the LWA credentials column.
!Amazon's Develop Apps list. One application row is shown with its name and ID hidden; the View link in the LWA credentials column is highlighted. Other applications are blurred out.
Which ID is the Client ID?
Which ID goes in Flow: If Starts with amzn1.application-oa2-client?: Client identifier (the LWA Client ID Flow asks for). Otherwise: amzn1.sp.solution is App ID (pasting it in Flow will not work).
The ID printed under the app name (amzn1.sp.solution.…) is the App ID. Click "View" in the LWA credentials column to open the panel with the real Client identifier.
!The LWA credentials panel opened from the View link. It shows the Client identifier beginning amzn1.application-oa2-client with the rest hidden, a Client secret section, and the Rotation Deadline date highlighted.
The same panel shows your Rotation Deadline — the exact date and time your current secret stops working. Note it; you will compare it in Flow.
How do I generate the new secret?
In the same LWA credentials panel, choose the option to generate or rotate the client secret. Amazon shows the new secret once — copy it straight away, or you must generate another.
Your old secret keeps working until its deadline, so there is no rush between generating and pasting it, and your store is never broken in between.
Will I have to reconnect Amazon after changing the secret?
No. Your authorisation stays valid: no re-authorising, no new refresh token, no re-entering your Seller ID. Regions, marketplaces, order sync and stock push settings are untouched.
Where do I enter the new secret in Flow?
Only a Global Admin can open Sales Channels and save account credentials. If you see the expiry banner but are not one, ask your Global Admin.
- Open Sales Channels (Admin → Sales Channels) and the Amazon tab.
- In the Account credentials box above the region cards, paste the secret into LWA Client Secret. Leave LWA Client ID as it is; it does not change on rotation.
- Answer "Was this secret rotated today?": Yes sets today as the rotation date; No lets you pick the day you generated it.
- Check Expires on (rotation date plus 180 days) against the Rotation Deadline from Amazon and correct it if they differ. Amazon's deadline includes a time of day, so the calculated date can be a day out either way.
- Click Save account credentials.
You should see a confirmation naming every region saved, for example *"Saved. Regions updated (3): EU, FE, NA."*
Do I update the secret for every Amazon region?
No. Amazon issues one client ID and secret per application, the same in every region. Enter them once in Account credentials; Flow saves them to all your Amazon regions in one step: either every region is updated or none is, so no region can be left on an old secret. Only your Seller ID and authorisation differ per region. Older versions of Flow had the secret in each region's form; that is no longer the case.
How do I know the new secret worked?
After saving, click Refresh Amazon at the top of the Amazon tab. It signs in to Amazon with the saved secret for every region. If a region shows "Amazon check failed", the secret was not accepted. You can also watch new orders appear at the next sync and stock changes reach Amazon again.
My secret already expired — what now?
Follow the same steps; nothing is permanently broken, and order import and stock push resume by themselves once a working secret is saved. Then:
- Check Amazon stock levels. Amazon kept the last number it received, which may be too high if you sold in the meantime.
- Check for missed orders. Orders placed while the connection was down are imported on recovery but arrive late.
Why does Amazon say "invalid_client" or my connection shows an authentication error?
invalid_client almost always means the client secret is wrong or expired. Usual causes, most common first:
- Past 180 days. Rotate the secret (this page).
- Copied incompletely. A missing character at either end is easy to do; re-copy it.
- App ID pasted as Client ID. Use the real Client identifier (see "Which ID is the Client ID?").
If you have just pasted a new secret and get this error straight away, re-copy it from Amazon and paste it again before assuming anything else is wrong.
When will I have to do this again?
180 days after the rotation date you entered. Flow shows it in Expires on in Account credentials and warns you 20 days before.
If Expires on is empty no warning can be produced, and you would only learn of it from Amazon's 30-day notice or the connection breaking. Enter the date even if you rotated some time ago.
Related
- Connecting your Amazon seller account
- Adding a sales channel and keeping its connection healthy
- Out of sync with channels - when a marketplace shows a different stock than you have