Creators API Setup

This guide explains how to set up the Amazon Creators API in ASA2.

Prerequisites

Before you begin, make sure you have:

  • PHP 8.1 or higher installed on your server

  • An Amazon Associates account for the marketplace(s) you want to use

  • Access to Amazon Associates Central to create API credentials

Step 1: Create Credentials at Amazon

To use the Creators API, you need to create API credentials at Amazon Associates Central.

  1. Log in to your Amazon Associates account

  2. Navigate to the Creators API section (also called “Product API” in some regions)

  3. Create new credentials for your marketplace

  4. Copy the Credential ID and Credential Secret

For detailed instructions, see Amazon’s official guide: Register for Creators API

Note

Each Amazon marketplace requires separate credentials. For example, if you want to use products from both amazon.de and amazon.com, you need to create credentials in both the German and US Associates programs.

Links to Amazon Associates Central by country:

For a complete list of all supported countries, see Supported Amazon PA API country stores.

Step 2: Open Creators API Setup in ASA2

In your WordPress admin, navigate to ASA2 → Setup and click on the Amazon Creators API tab.

ASA2 Setup page with Creators API tab

The setup page shows three tabs:

  • Amazon PA API: Traditional PA API 5.0 configuration

  • Amazon Creators API: New Creators API configuration (recommended)

  • Associate ID Sets: For internationalization features

Step 3: Add Marketplace Credentials

Click the “+ Add Marketplace” button to add credentials for a marketplace.

Add Marketplace Credentials form

Fill in the following fields:

Marketplace

Select the Amazon marketplace (country) for these credentials.

Credential ID

Your Creators API Credential ID from Amazon Associates Central.

Credential Secret

Your Creators API Credential Secret. This will be stored encrypted in the database.

Partner Tag (Tracking ID)

Your Amazon Associates Tracking ID for this marketplace. This must match the Associates account linked to your Creators API credentials.

Enable Marketplace

Check this to enable the marketplace for product lookups. You can temporarily disable a marketplace without deleting the credentials.

Set as Default Marketplace

Check this if you want this marketplace to be used when no specific country is selected.

Click “Add Marketplace” to save the credentials.

Step 4: Verify Configuration

After adding credentials, you’ll see the marketplace in the Configured Marketplaces table:

Configured Marketplaces table

The table shows:

  • Marketplace: The country name

  • Status: Whether the marketplace is enabled or disabled

  • API Version: The Creators API version being used

  • Partner Tag: Your tracking ID (partially hidden for security)

  • Default: A star indicates the default marketplace

  • Actions: Edit or delete the configuration

Step 5: Test the Connection

To verify that your Creators API credentials are working:

  1. Go to ASA2 → Products

  2. Add a new product or refresh an existing one

  3. Check that product data loads correctly

If the Creators API is working, ASA2 will automatically use it for product lookups. You can verify this in the product data or by enabling Logging.

PA API Status When Creators API is Active

When the Creators API is enabled, the PA API setup page will show an informational notice:

PA API status when Creators API is active

The notice indicates that PA API is not being used because Creators API is active. Your PA API credentials remain stored and will be used automatically if Creators API is disabled or for marketplaces without Creators API credentials.

Next Steps