Skip to main content

Authorization

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

UpPromote

Prerequisites​

Before creating an UpPromote credential, you need to obtain your Bearer Token from your UpPromote account. UpPromote uses Bearer token authentication for all API requests.

To obtain your UpPromote Bearer Token, follow these steps:

  1. Sign in to your UpPromote account using your administrator credentials.

  2. Navigate to Integrations in your UpPromote account dashboard, typically accessible from the main navigation menu or settings.

  3. In the Integrations section, navigate to the APIs tab or API Settings to access API token management.

  4. Look for the API Token or Bearer Token section in your UpPromote API settings.

  5. If you don't have an API token yet, click Generate Token or Create API Token to create a new API token.

  6. Configure your token settings:

    • Enter a name for the token (e.g., "Nexla Integration")
    • Review the token permissions or scopes (if applicable)
    • Click Create or Generate to create the token

  7. After the token is created, copy the Bearer Token or API Token value immediately, as it may not be accessible again after you navigate away from the page.

  8. Store the token securely, as you will need it to configure your Nexla credential. The Bearer Token is sensitive information and should be kept confidential.

The Bearer Token is sent in the Authorization header for all API requests to the UpPromote API. The token authenticates your requests and grants access to UpPromote resources based on your account permissions. If your token is compromised, you should immediately revoke it in your UpPromote account settings and generate a new one. For detailed information about obtaining API tokens, API authentication, and available endpoints, refer to the UpPromote API documentation.

Create an UpPromote Credential​

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

New Credential Overlay – UpPromote

UpPromoteCred.png

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 provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

Bearer Token Authentication​

UpPromote uses Bearer token authentication for all API requests. The Bearer Token is sent in the Authorization header.

  1. Enter your Uppromote Bearer Token in the Uppromote Bearer Token field. This is the token generated that authorizes your application. Click on Integrations, go to APIs tab and copy the API token. The token is sent as a Bearer token in the Authorization header for all API requests to the UpPromote API. The Bearer Token is sensitive information and must be kept confidential.

    Your UpPromote Bearer Token can be found in your UpPromote account under Integrations > APIs tab. Click on Integrations, go to APIs tab and copy the API token. The token is sent as a Bearer token in the Authorization header for all API requests to the UpPromote API.

    If your token is compromised, you should immediately revoke it in your UpPromote account settings and generate a new one. The Bearer Token provides access to your UpPromote account data and should be treated as sensitive information. Keep your token secure and do not share it publicly.

    For detailed information about obtaining API tokens, API authentication, and available endpoints, see the UpPromote API documentation and UpPromote API overview.

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.