How to Add Your Own Amazon Creators API Credentials

This is optional. Your FreshStore Amazon stores work without your own credentials. Adding your own is a quick way to get faster data and unlock more countries.

This guide walks you through adding your own Amazon Creators API credentials to FreshStore. The process takes about 10 minutes.

Before You Start

You will need:

An Amazon Associates account for the country you want to set up (e.g., amazon.com for US, amazon.co.uk for UK).
10 or more sales in the last 30 days on that marketplace. This is Amazon's requirement for API access.

If you do not have 10 sales yet, you can skip this guide for now. Your stores work fine, and you can come back once you qualify.

Step-by-Step

1. Sign into Amazon Associates

Go to the Amazon Associates website for the country you want to set up:

US: affiliate-program.amazon.com
UK: affiliate-program.amazon.co.uk
Germany: partnernet.amazon.de
France: partenaires.amazon.fr
Other countries: Go to the Amazon Associates page for your local Amazon website.

2. Open the Creators API page

Once you are signed in:

Click the menu icon (three lines) in the top right.
Click Tools.
Click CreatorsAPI.

3. Create an application

Click the Create App button.
Fill in the details:
- Application name: Anything you like, e.g., "My FreshStore"
- Description: Something simple like "Product data for my website"
- Website URL: Your store's web address
Click Submit.

4. Create your credentials

Once your application is approved (this is usually instant if you have 10+ sales), click Add new credential. Amazon will give you two things:

An OAuth Client ID (starts with amzn1.application-oa2-client... )
An OAuth Client Secret

Copy both values straight away. The Client Secret may only be shown once, so save it somewhere safe.

5. Add them to FreshStore

Log into your FreshStore dashboard.
Go to Settings > Amazon.
Open the Creators API section.
Paste in your OAuth Client ID and OAuth Client Secret.
Select your Credential Version:
- 3.1 if your marketplace is US, Canada, Mexico, or Brazil
- 3.2 if your marketplace is UK, Germany, France, Italy, Spain, or another European country
- 3.3 if your marketplace is Japan, Australia, Singapore, or India
Click Save.

6. Check it works

Go to your store and search for any Amazon product. If results appear normally, your credentials are working.

Questions

Do I have to do this?

No. Your stores work perfectly without your own credentials. This is optional.

My application was not approved

You need at least 10 qualifying sales in the last 30 days on that specific marketplace. If you are not there yet, keep going and come back when you qualify. Your stores work fine in the meantime.

Make sure you are signed into the correct Amazon Associates account for the right country. The Creators API option only appears if your account is eligible.

Something is not working after adding credentials

Check you selected the right Credential Version for your country.
Make sure you copied the full Client ID and Client Secret without any extra spaces.
If it still does not work, contact our support team and we will help.

I want to add credentials for more than one country

Just repeat this process for each country. Each Amazon marketplace is separate, so you need a different application for each one.

Need Help?

Click the help beacon in the bottom-right corner of your FreshStore dashboard, or email our support team. We can see your credential status on our end and help sort out any issues.