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:

Sign in with the Amazon account linked to your Associates membership.

2. Open the Creators API page

Once you are signed in:

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

3. Create an application

  1. Click the Create App button.
  2. 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
  3. 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

You can add credentials in two places. Pick the one that fits your situation:

Option A: At your FreshStore account (recommended for new stores)

Credentials saved here are automatically applied to any new stores you create from this account. They do not retroactively update existing stores.

  1. Go to my.freshstore.com/account/settings and sign in.
  2. Find the Amazon Associates section.
  3. Choose the Amazon Marketplace (country) you are adding credentials for.
  4. Open the Amazon Creators API section.
  5. Paste in your OAuth Client ID and OAuth Client Secret.
  6. Click Save. Repeat for each marketplace you have credentials for.

Option B: Inside an existing store's dashboard

Use this for stores that were created before you saved your credentials at the account level, or if you want different credentials for a specific store.

  1. Log into the store dashboard.
  2. Go to Settings > Amazon (under Affiliate Settings).
  3. Open the Amazon Creators API section.
  4. Paste in your OAuth Client ID and OAuth Client Secret for each enabled country.
  5. Click Save.

If you have several existing stores, you need to repeat Option B for each one. There is no bulk apply.

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.

I saved credentials at the account level but my existing store still uses the default

That is expected. Account-level credentials only apply to new stores created after you saved them. To use your credentials in an existing store, follow Option B and add them inside that store's dashboard.

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.

I cannot find Creators API in the Tools menu

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

  • Make sure you copied the full Client ID and Client Secret without any extra spaces.
  • Ensure your Amazon account has received recent qualifying sales.
  • Confirm you saved the credentials in the right place (account vs. individual store).
  • 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. In Option A, change the Amazon Marketplace dropdown for each set of credentials. In Option B, fill in the OAuth fields for each enabled country.

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.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Related Guides