Skip to main content

Authorization

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

Outbrain Engage

Prerequisites​

Before creating an Outbrain Engage credential, you need to identify your API server URL and obtain your Outbrain username and password. Outbrain Engage uses token-based authentication, where your username and password are used to obtain an API token that is then used for all subsequent API requests.

To obtain your Outbrain Engage credentials, follow these steps:

  1. Sign in to your Outbrain Engage account using your Outbrain account credentials.

  2. Navigate to your Outbrain Engage dashboard or account settings in the Outbrain interface.

  3. Identify your API server URL. The default API server URL for Outbrain Engage is https://api.outbrain.com/engage/v2. This URL is used for all API requests to the Outbrain Engage API.

  4. Your Outbrain username is the username you use to sign in to your Outbrain Engage account. This username is used to authenticate with the Outbrain Engage API and obtain an API token.

  5. Your Outbrain password is the password associated with your Outbrain Engage account. This password is used along with your username to authenticate with the Outbrain Engage API and obtain an API token.

  6. Store all credentials securely, as you will need them to configure your Nexla credential. The username and password are sensitive information and should be kept confidential.

The username and password are used to authenticate with the Outbrain Engage API login endpoint (/login) to obtain an API token. The API token is then sent in the Authorization header with the Bearer prefix for all subsequent API requests. The API token is automatically obtained and refreshed by Nexla as needed. If your credentials are compromised, you should immediately change your password in your Outbrain account settings. For detailed information about Outbrain Engage authentication, API access, and available endpoints, refer to the Outbrain Engage API documentation.

Create an Outbrain Engage Credential​

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

New Credential Overlay – Outbrain Engage

OutbrainEngCred.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.

Token Authentication​

Outbrain Engage uses token-based authentication for all API requests. Your username and password are used to authenticate with the Outbrain Engage API login endpoint to obtain an API token, which is then used for all subsequent API requests.

  1. Enter your Outbrain Engage API server URL in the API Server URL field. The default API server URL is https://api.outbrain.com/engage/v2. This URL is used for all API requests to the Outbrain Engage API, including the login endpoint for token authentication.

  2. Enter your Outbrain username in the Outbrain Username field. This is the username you use to sign in to your Outbrain Engage account. The username is used along with your password to authenticate with the Outbrain Engage API login endpoint and obtain an API token.

  3. Enter your Outbrain password in the Outbrain Password field. This is the password associated with your Outbrain Engage account. The password is used along with your username to authenticate with the Outbrain Engage API login endpoint and obtain an API token. The password is sensitive information and must be kept confidential.

    Your Outbrain Engage credentials can be found in your Outbrain Engage account. The username and password are used to authenticate with the Outbrain Engage API login endpoint (/login) to obtain an API token. The API token is then automatically sent in the Authorization: Bearer {token} header for all subsequent API requests to the Outbrain Engage API.

    The API token is automatically obtained and refreshed by Nexla as needed. If your credentials are compromised, you should immediately change your password in your Outbrain account settings. The username and password provide access to your Outbrain Engage account data and should be treated as sensitive information. Keep your credentials secure and do not share them publicly.

    For detailed information about Outbrain Engage authentication, API access, and available endpoints, see the Outbrain Engage API documentation.

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.