Migrating from PA API 5.0

• Timeline
• 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
• Keeping PA API as Backup
• Troubleshooting
  • Products show no price data
  • API returns errors
  • invalid_client Error
• Related Topics

This guide helps you migrate from the traditional Product Advertising API (PA API) 5.0 to Amazon's new Creators API.

Timeline

WARNING

Important Deadline: On January 31, 2026, Amazon will retire the Offers V1 format in PA API 5.0. After this date, PA API will no longer return pricing data in the old format.

Date	Event
Now	Creators API available, PA API still works fully
January 31, 2026	PA API Offers V1 retired (no more pricing via V1)
TBD	Full PA API 5.0 retirement (not yet announced)

We recommend setting up Creators API credentials before the January 2026 deadline to ensure uninterrupted access to pricing data.

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

• New setup section for Creators API credentials
• API automatically switches based on your configuration
• 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

Before deadline: Ensure all actively used marketplaces have Creators API credentials

This gradual approach lets you:

• Identify any issues early
• Roll back easily if problems occur
• Test thoroughly with real products

Keeping PA API as Backup

Your PA API credentials remain stored even after enabling Creators API. They serve as an automatic fallback for:

• Marketplaces without Creators API credentials
• Situations where Creators API is disabled
• Emergency fallback using the ASA2_FORCE_PAAPI5 constant

There's no need to delete your PA API configuration.

Troubleshooting

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