Skip to main content

Authorization

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

EasyPromos

Prerequisites​

To connect Nexla to EasyPromos, you need an active EasyPromos account with API access. The EasyPromos REST API is available exclusively to customers on the White Label or Corporate plan. If your account is on a lower-tier plan, you will need to upgrade before generating API credentials.

Obtain an EasyPromos API Key​

EasyPromos authenticates API requests using Bearer tokens generated within the EasyPromos application. Follow the steps below to create a token for use in Nexla.

  1. Log in to your EasyPromos account at easypromosapp.com.

  2. Navigate to Settings > Integrations > Developers. Alternatively, you can access the Developers section from the Utilities dropdown menu in your account.

  3. On the Developers page, click Create new token to generate a new API token.

  4. By default, newly created tokens have a 30-day expiration. To extend the token's validity, click the Pencil (edit) icon next to the token and select a longer duration from the Extend by dropdown — options include up to one year.

  5. Copy the generated token and store it securely. This token will be used as the API Key when configuring the credential in Nexla.

EasyPromos API tokens are sensitive credentials — treat them like passwords and do not share them publicly. If a token is compromised, return to Settings > Integrations > Developers in your EasyPromos account to revoke it and generate a new one.

API Plan Requirement

The EasyPromos REST API is only available on the White Label or Corporate plan. Attempting to authenticate with an account on a lower-tier plan will result in authorization errors.

For additional details on token management, refer to the EasyPromos API reference and the Getting started with the Easypromos REST API guide.

Create an EasyPromos Credential​

  • To create a new EasyPromos 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.

API Key​

  1. Enter your EasyPromos API token in the API Key field. This token authenticates all requests Nexla makes to the EasyPromos API on your behalf and is transmitted as a Bearer token in the Authorization request header.

Base URL​

  1. The Base URL field is pre-populated with the default EasyPromos API endpoint: https://api.easypromos.com. This is the correct production URL for all EasyPromos API calls and should not be changed unless directed by EasyPromos support.

    The Base URL dropdown includes a single Production option (https://api.easypromos.com). Select this option to connect to the live EasyPromos environment.

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.