ASA2 Documentation

Appearance

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

INFO

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 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 Type Select the type of your Creators API credentials.

  • Cognito (v2): Choose this for credentials you created before February 2026. These are the original Creators API credentials that use Amazon Cognito for authentication.
  • LWA (v3): Choose this for credentials issued since February 2026. These newer credentials use Login with Amazon (LWA) for authentication.

The API version is automatically determined based on your credential type and marketplace. Cognito credentials use API versions 2.1–2.3, while LWA credentials use API versions 3.1–3.3. You do not need to select the API version manually.

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.

Troubleshooting

If you receive an "invalid_client" error after entering your credentials, your credentials may be LWA (v3) type. Try editing the marketplace and switching the Credential Type to "LWA (v3)". See also invalid_client Error in the migration guide.

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
  • Credential Type: Whether this marketplace uses Cognito (v2) or LWA (v3) credentials
  • API Version: The Creators API version being used (2.x for Cognito, 3.x for LWA)
  • 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 Options 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 ​

ASA2 - The Amazon Affiliate Plugin for WordPress

© 2026 getasa2.com