Migrating from PA API 5.0

• What Changes?
  • What stays the same
  • What's new
• Migration Steps
  • Step 1: Check PHP Version
  • Step 2: Update ASA2
  • Step 3: Create Creators API Credentials
  • Step 4: Configure ASA2
  • Step 5: Test
  • Step 6: Verify API Selection
• Gradual Migration Strategy
• What Happens to Your PA API Credentials
• Troubleshooting
  • "No Amazon Creators API credentials are configured for the marketplace ..."
  • "Product Advertising API is deprecated. Please migrate to Creators API."
  • Products show no price data
  • API returns errors
  • invalid_client Error
• Related Topics

This guide helps you move an existing PA API 5.0 setup over to the Amazon Creators API.

WARNING

Amazon has retired the Product Advertising API. Until you have Creators API credentials for a marketplace, ASA2 cannot load or update products from it.

What Changes?

What stays the same

• All existing products continue to work
• Template placeholders remain compatible
• Shortcodes work exactly as before
• Collections and Smart Collections unchanged
• Custom products unchanged
• Your existing templates don't need modifications

What's new

• A separate setup tab for Creators API credentials
• Credentials are configured per marketplace instead of once for your whole account
• Enhanced pricing data with Offers V2 format
• New template placeholders for availability information (see Placeholders Availability)

Migration Steps

Step 1: Check PHP Version

The Creators API requires PHP 8.1 or higher. Check your PHP version in WordPress:

1. Go to Tools → Site Health
2. Click Info tab
3. Expand Server section
4. Look for PHP version

If your version is below 8.1, contact your hosting provider about upgrading.

Step 2: Update ASA2

Make sure you're running ASA2 1.29.0 or later. Check your version in ASA2 → Dashboard.

Step 3: Create Creators API Credentials

For each marketplace you use:

1. Log in to Amazon Associates Central for that country
2. Navigate to the Creators API / Product API section
3. Create new API credentials
4. Note down the Credential ID and Credential Secret

INFO

Credentials created since February 2026 are LWA (v3) type. When configuring these in ASA2, make sure to select "LWA (v3)" as the Credential Type. Older credentials use "Cognito (v2)".

See Creators Api Setup for detailed instructions.

Step 4: Configure ASA2

1. Go to ASA2 → Setup
2. Click the Amazon Creators API tab
3. Click "+ Add Marketplace"
4. Enter your credentials for each marketplace
5. Enable the marketplace and save

Step 5: Test

1. Go to ASA2 → Products
2. Refresh an existing product or add a new one
3. Verify that product data loads correctly
4. Check pricing information is displayed

Step 6: Verify API Selection

To confirm ASA2 is using the Creators API:

1. Enable logging in ASA2 → Options → Logging
2. Refresh a product
3. Check the log entries for API selection information

Gradual Migration Strategy

You don't need to migrate all marketplaces at once. ASA2 supports a mixed configuration:

Week 1: Configure and test with your primary marketplace (e.g., Germany)

Week 2: Add additional marketplaces one by one

Week 3: Verify all products are loading correctly

This gradual approach lets you identify issues early and test thoroughly with real products. Products from marketplaces you have not configured yet are simply not updated until you add their credentials.

What Happens to Your PA API Credentials

Your PA API credentials stay stored and the Amazon PA API tab stays available so you can review them. They are not used for product requests any more — Amazon has retired that API.

There is no need to delete your PA API configuration, but it also does not substitute for missing Creators API credentials. Every marketplace you want product data from needs its own Creators API credentials.

Troubleshooting

"No Amazon Creators API credentials are configured for the marketplace ..."

The message names the exact marketplace that is missing credentials. Open ASA2 → Setup → Amazon Creators API and add credentials for that marketplace. See Multi Marketplace if you use several marketplaces.

A variant of the message says the credentials are disabled. In that case they already exist — open the same page and enable the marketplace.

"Product Advertising API is deprecated. Please migrate to Creators API."

This is Amazon's own error from the retired PA API. If you see it, one of two things is true:

• Your PHP version is below 8.1, so the Creators API cannot be used — ask your hosting provider to upgrade.
• The constant ASA2_FORCE_PAAPI5 is defined in your wp-config.php — remove that line. It is a debugging aid only and always ends in this error.

Products show no price data

• Verify your Creators API credentials are correct
• Check that the marketplace is enabled
• Ensure your PHP version is 8.1+
• Check the logs for error messages

API returns errors

• Double-check your Credential ID and Secret
• Verify your Partner Tag matches your Associates account
• Make sure you have the correct permissions in Amazon Associates Central

invalid_client Error

If you receive an "invalid_client" error when testing your Creators API connection, your credentials may be the newer LWA (v3) type. Amazon started issuing LWA credentials in February 2026. To fix this:

1. Go to ASA2 > Setup > Amazon Creators API
2. Click Edit on the affected marketplace
3. Change the Credential Type from "Cognito (v2)" to "LWA (v3)"
4. Click Update Marketplace

Related Topics

• Creators Api - Creators API overview
• Creators Api Setup - Setup guide
• Creators Api Multi Marketplace - Multi-marketplace configuration
• Placeholders Availability - New availability placeholders