Awin
Connect Awin to track affiliate sales and commission, find programmes, build tracking links, read offers, and approve transactions.
You paste one value into PopMCP: your personal Awin API token, from API Credentials in your user menu. If your login belongs to several publisher or advertiser accounts, you then choose which one the connection is for.
- Setup time
- 1 min
- Auth
- API credentials
- API base URL
- https://api.awin.com
- Rate limits
- 20 API calls a minute per person, across everything using the token. Enhanced feed downloads: 5 a minute, one at a time per advertiser.
Before you begin
- An Awin login with access to a publisher or advertiser account
- Nothing to apply for as a publisher: your token works as soon as you show it
- As an advertiser, the Accelerate or Advanced plan, or an Access login listed on more than one programme
Get your credentials
Open API Credentials
Sign in to Awin. Open your user menu at the top right and select API Credentials, or go straight to ui.awin.com/awin-api. You need at least viewer access to the account you want to reach, and Awin asks for admin access to set up a token, so ask your admin if you do not see your account.
API Credentials
Show and copy your token
Enter the password you use to sign in and select Show my API token. Awin creates the token the first time and shows it. Copy it. It works like a password and reaches every Awin account your login belongs to, so keep it out of chats and shared files.
API Credentials
Revoking stops everything that uses this token straight away, including PopMCP. Only do it if the token has leaked.
Paste the token into PopMCP and choose the account
In PopMCP, paste the token into API token and connect. PopMCP checks it and lists the Awin accounts your login belongs to; choose the one this connection is for (each one goes into its own PopMCP workspace). The connection is then locked to that account. A change to your access in Awin can take up to 10 minutes to reach the API.
Optional: add a product feed key
Only for publishers who want Awin's standard product feeds. Enhanced feeds need no key. In Awin, open Toolbox, then Create-a-Feed, choose a language and a feed, go through column selection, and copy the generated link. In PopMCP, open More options and paste the whole link into Product feed key. PopMCP takes the key out of it. This key is separate from your API token.
Create-a-Feed
Connect in PopMCP
Open your workspace, choose Awin in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API tokensecret | In Awin, open your user menu at the top right, then API Credentials. Enter your password, choose Show my API token, then copy it. Stored encrypted.Encrypted with AES-256-GCM on save and never shown again. |
| Product feed key (optional)secret | Only for publishers reading Awin's standard product feeds. In Awin, open Toolbox, then Create-a-Feed, and paste the download link. Enhanced feeds need no key. Stored encrypted.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against Awin immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP marks the Awin connection Verified with the account's name, and records whether it is a publisher or an advertiser and your role in it. Asking the AI how much commission is pending returns totals by currency.
Troubleshooting
Awin did not accept this token
Why:
Fix: The token was revoked or not copied whole. Open API Credentials in Awin, enter your password, and copy it again. If it was revoked, a new one is made when you show it.
This token can no longer open the Awin account
Why:
Fix: Your login lost access to that account. Ask an admin of the account to add you again. A change of access can take up to 10 minutes to reach the API.
Awin allows 20 API calls a minute
Why:
Fix: The limit is per person and covers everything using your token, including any other tool you connected with it. Wait a minute and try again.
Advertiser tools are refused with 403
Why:
Fix: Awin offers its advertiser APIs on the Accelerate and Advanced plans. Check your plan with your Awin contact.
A tracking link comes back with an unknown error
Why:
Fix: Some advertisers do not allow the link builder, and a page outside the advertiser's valid domains is refused. Ask the AI to check the programme's details.
A report says region is required
Why:
Fix: Most Awin reports cover one region at a time. Name one, such as GB, or ask for a summary across regions, which PopMCP merges for you.
Standard product feeds ask for a key
Why:
Fix: They use a separate key from Create-a-Feed. Connect Awin again and paste the download link under Product feed key. Enhanced feeds work without one.