Migrating from PA API 5.0

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 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

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