Summary
The content of the article below organizes all the steps you need to follow based on your profile (Agency/Private Owner) when connecting your Amazon Account and troubleshoot any error messages you may come across while connecting your Amazon Account.
Start Below with the first question to help guide you towards the correct connection instructions.
Account Connection Procedure
Entity Connecting an Account
Under which profile are you connecting your Amazon Account?
Agency Requirements
The following requirements are crucial to initiate a successful connection of your Amazon Seller Account to Perpetua:
1️⃣ Active Advertising Campaign
At the time of connecting your account, you should have active advertising campaigns.
If otherwise, create a campaign from Amazon to activate advertising, and allow up to 24 hours for the data to sync on Perpetua.
2️⃣ Admin Permission
The Amazon login that you will use to connect the AAA ((Amazon Advertising API) has Admin Permissions on the Campaign Manager
If not, the account owner will need to grant you "View and Edit" permissions by following these instructions.
🚨 Note: The user account that connects the AAA must have advertising permissions on Seller Central to also connect the SP-API. If you have the required "View and Edit" permissions already enabled, ask the owner of the account, to remove all the users and add them back again. This will trigger a refresh. For some reason, Amazon's API can be finicky and can sometimes fail to recognize a valid user. 🚨
Once you have met the requirements, continue with the following step below. 👇
What type of Account are you Trying to Connect to Perpetua?
Private Owner Requirements
The following requirement is crucial to initiate a successful connection of your Amazon Seller Account to Perpetua:
1️⃣ Active Advertising Campaign
At the time of connecting your account, there are active advertising campaigns.
If otherwise, create a campaign from Amazon to activate advertising, and allow up to 24 hours for the data to sync on Perpetua.
Once you are assured of the above, continue with the next step below. 👇
What type of Account are you Trying to Connect to Perpetua?
Seller Account Connection Guide
When connecting an Amazon Seller account to Perpetua, you're required to establish connections through two distinct channels:
AAA (Amazon Advertising API) - provides us with access to advertising data & allows Perpetua to optimize campaigns (ie. launch campaigns, etc.)
SP-API (Seller Partner API) - provides us with product data (ie. New ASINs, inventory levels)
Is this the first account that you connect to Perpetua?
Vendor Account Connection Guide
When connecting an Amazon Vendor account to Perpetua, you're required to establish a connection to:
AAA (Amazon Advertising API) - provides us with access to advertising data & allows Perpetua to optimize campaigns (ie. launch campaigns, etc.)
🚨 Note: Connecting the account to the SP-API connection is not necessary. However, is highly recommended to gain access to Sales & Traffic Reporting as well as help our team troubleshoot any concerns promptly. 🚨
Is this the first account that you connect to Perpetua?
Account Connection Error Messages
Requirements for connecting Amazon Account to Perpetua
The following requirements are crucial to initiate a successful connection of your Amazon Seller Account to Perpetua:
1️⃣ Active Advertising Campaign
At the time of connecting your account, you should have active advertising campaigns.
If otherwise, create a campaign from Amazon to activate the advertising, and allow up to 24 hours for the data to sync on Perpetua.
2️⃣ Admin Permission
The Amazon login that you will use to connect the AAA has Admin Permissions on the Campaign Manager
If not, the account owner will need to grant you "View and Edit" permissions by following these instructions.
🚨 Note: The user account that connects the AAA must have advertising permissions on Seller Central to also connect the SP-API. If you have the required "View and Edit" permissions already enabled, ask the owner of the account (if you are an agency), to remove all the users and add them back again. This will trigger a refresh. This is because Amazon’s API can sometimes fail to recognize a valid user 🚨
What type of error message are you experiencing?
Amazon Advertising Error
Reason
The AAA does not "match" the SP-API account
💡 How to Fix
Click on the purple "Refresh" Button;
Never run Amazon Ads? Enable Advertising in Seller Central. View the instructions here.
Enable "Advertising Permissions". View the Instructions here.
🚨Note: if you have the required "View and Edit" permissions already enabled, ask the owner of the account (if you are an agency), to remove all the users and add them back again. This will trigger a refresh. This is because Amazon’s API can sometimes fail to recognize a valid user.🚨
You may have logged into an Amazon Account without Amazon Advertising enabled. Click on "Connect Different Account" to log in to the correct one.
If the issue persists, reach out to your Data Strategist or our Customer Support team on Live Chat Support located at the bottom right of your screen. 📩
Connect Selling Partners Error
Reason: You will see this message if the connection to the SP-API fails when trying to connect to your Amazon account. The dialogue in grey will say something different depending on what the cause of the error is.
How does the message you are experiencing continue?
👉 "Please try again."
📍Connect Selling Partners - "Please Try Again."
Reason
Internal Server Error
Wrong Merchant ID entered
Merchant ID out of date
💡How to Fix
Please repeat the account connection process and try again.
Try clearing the cache of the browser you are using.
Try using a different browser, or using an incognito tab to see if this works.
Review of the Merchant ID is linked to the account you are connecting
Review of your Merchant ID is up to date (Reach out to Amazon Support to verify)
If it does not work, then please reach out to us.
📍Connect Selling Partners - "This account is already in use. Please Try Again."
Reason
There is an existing account connected to the SP-API already
💡 How to Fix
Ensure you don't have an already-connected account to Perpetua.
Please reach out to us to see if there's an existing account connected.
📍Connect Selling Partners - "Failed to retrieve refresh token. Please try again."
Reason
You are not participating in the marketplace. Please confirm that you are.
A different region was selected in Perpetua than the one you are logging into with your Amazon account.
💡 How to Fix
Review the login used to connect the account. Ensure you are using the ones related to the marketplace you selected among the ones shown on Perpetua at the time of connecting.
Try clearing the cache of the browser you are using.
Try using a different browser, or using an incognito tab to see if this works.
If it does not work, then please reach out to to our Live Chat Support..
📍Connect Selling Partners - "Session has expired. Please try again."
Reason
Took too long on SP-API connection step.
💡 How to Fix
Try repeating the connection process after clearing the cache and cookies from your browser.
Reach out to support if it persists.
📍Connect Selling Partners - "Failed to create geocompany. Please try again."
Reason
We failed to create an account related to the country you are connecting on our backend.
💡 How to Fix
Please try going through the account connection one more time.
Try clearing the cache of the browser you are using.
Try using a different browser, or using an incognito tab to see if this works.
If it does not work, then please reach out to us.
We no longer have access to the SP API
Reason
To increase security measures for sellers, Amazon has initiated a new program known as Developer Access Confirmation. Under this program, sellers are required to reaffirm access to developers like Perpetua every 12 months, also referred to as re-authentication of the SP-API.
Failure to confirm access may result in a notification appearing at the bottom of your Perpetua screen, as the SP-API will automatically disconnect.
💡 How to Fix
By clicking on the "Reconnect Selling Partner API" button.
Article last updated March 2024. If you find this information to be out of date, please contact hello@perpetua.io.