Skip to main content

Authorization

Follow this guide to create a new AWIN Advertiser credential that will allow Nexla to authenticate to and exchange data with your AWIN Advertiser account.
awin_advertiser_api_auth.png

AWIN Advertiser

Prerequisites​

The AWIN Advertiser API uses OAuth 2.0 bearer token authentication. The access token is generated from the Awin user interface and is linked to your personal user account—it grants access to data for every advertiser account that your user can manage on the Awin platform.

Awin Account Requirements​

  • An active Awin advertiser account is required to use this connector. Advertiser APIs are only available to advertisers on the Awin Accelerate or Advanced plans, so confirm that your account is on a supported plan before proceeding.

  • Note your Advertiser ID before configuring data flows. This numeric identifier is required by most endpoints and can be found in the Awin advertiser dashboard URL or under your account profile.

  • Awin enforces a throttling limit of 20 API calls per minute per user. Plan ingestion frequency and pagination settings accordingly to avoid rate-limit errors.

Generate Your AWIN API Token​

  1. Sign in to the Awin platform at https://ui.awin.com using your Awin username and password.

  2. Open the API Credentials page directly, or click your user menu in the top-right corner and select API Credentials.

  3. On the API Credentials page, enter the password that you use to log in to the Awin website in the password field.

  4. Click the Show my API token button. Your personal API token will be generated and displayed on the page.

  5. Copy the displayed token value to your clipboard. You will paste this raw token into Nexla when creating the credential—do not include any prefix such as Bearer when copying, since Nexla adds the prefix automatically.

    Your API token is tied to your individual user account, not to a specific advertiser. The token grants access to data for every advertiser account that your user can manage on the Awin platform. If the token is ever compromised, return to the API Credentials page, enter your password, and click Revoke my API token to invalidate it and generate a new one.

For additional reference, see the Awin API authentication documentation and the Awin APIs overview.

Create an AWIN Advertiser Credential​

  • To create a new AWIN Advertiser credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

AWIN API Token​

  1. Paste the API token that you generated from the Awin API Credentials page into the API Key Value field. Enter only the raw token value—do not prepend Bearer to the token, because Nexla automatically adds the Bearer prefix when calling the standard Awin endpoints and reuses the same value as the x-api-key header for the proof-of-purchase submission endpoint.

    Treat the API token like a password. Anyone with this token can read and modify data for every advertiser account your Awin user can access. Store it only in secure credential systems, and rotate it from the Awin API Credentials page if you suspect it has been exposed.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.