1. 01

    Check that you are the primary user

    You need a professional selling account and you must be its primary user. Amazon only lets that person create and authorize an app. If you work with an account manager or an agency, have them do these steps and pass you the three values.

  2. 02

    Go to Develop Apps

    Log in to Seller Central and click Apps and Services at the top, then Develop Apps. That takes you to the Developer Console.

    Or go straight to https://sellercentral.amazon.com/sellingpartner/developerconsole

  3. 03

    Fill in your developer profile

    The first time, Amazon asks for a developer profile: who you are and how you handle data. It includes security questions. Answer them truthfully; this is your own account and your own data. Amazon usually approves within a few working days.

  4. 04

    Create an app

    Click Add new app client. Give the app a name you will recognise, for example Schakel. Choose SP-API as the API type and tick Sellers. Leave the public option unticked: this app is for your own account.

  5. 05

    Pick the roles

    Tick Tax Invoicing (Restricted). That is the role that lets the buyer name and address come through, and without those two no valid invoice can be made. If you want to hand over as little as possible, this is enough: Schakel writes nothing back to Amazon and only needs to read your orders.

  6. 06

    Copy the Client ID and Client Secret

    Save the app. In the list, click View under LWA credentials for your app. You now see a Client ID starting with amzn1.application-oa2-client. and a Client Secret. Copy them both.

  7. 07

    Authorize the app and copy the refresh token

    Click Authorize app on that same app. Amazon then shows a refresh token starting with Atzr|. Copy it straight away: it is shown only once. If you lose it, press Authorize app again; you get a new token and the old one keeps working.

  8. 08

    Paste the three values into Schakel

    In Schakel, go to Connections, pick Amazon and paste the Client ID, the Client Secret and the refresh token. Leave the region on Europe. Schakel tests it right away and shows which marketplaces are on your account.

Worth knowing

  • One app covers all your European marketplaces. amazon.nl, amazon.de, amazon.fr and the rest run through the same account, so there is nothing to repeat per country.
  • A refresh token that goes unused for a year expires. That will not happen while the connector runs, because it uses it on every sync.
  • Amazon allows only a few order lookups per hour. The connector respects that, so after a manual sync the next one may take a while. Nothing is lost.
  • After connecting, Schakel does not pick ledger accounts for you. That step sits in the connector settings, together with the question of which marketplaces you want booked.

If something goes wrong

Schakel says Amazon does not recognise the Client ID and Secret.
Usually the two are swapped. The Client ID starts with amzn1.application-oa2-client. and the secret with amzn1.oa2-cs.. With the secret in the top field, Amazon answers exactly this way.
Schakel does not accept the refresh token.
The token is shown only once, so a half-copied token is the usual cause. Press Authorize app again and paste the new token. Also check that it starts with Atzr|.
The invoices carry no buyer name or address.
The app is missing the Tax Invoicing (Restricted) role. Open the app under Develop Apps, tick the role and then press Authorize app again: a token minted before the change carries the old permissions.
No orders are being read.
First check that marketplaces are switched on in the connector settings. If they all are, check the invoicing moment: by default Schakel waits until Amazon reports the order shipped, so today’s orders only appear once they ship.

Connectors that use your Amazon access

Once you hold the keys, this is where they go. Every connector below talks to Amazon.

Stuck on a step?

Screens move around. If what you see does not match the screenshots, message us and we will look at it with you, and fix the page.