Skip to main content

Authorization

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

Flexmail

Prerequisites​

Flexmail uses HTTP Basic Authentication, where your numeric Flexmail Account ID serves as the username and a Personal Access Token serves as the password. Before creating a credential in Nexla, you will need to locate your Account ID and generate a Personal Access Token from your Flexmail account settings.

Locate Your Flexmail Account ID​

Your Flexmail Account ID is a numeric identifier assigned to your Flexmail organization. It is used as the username in HTTP Basic Authentication requests to the Flexmail API.

  1. Sign in to your Flexmail account at flexmail.be.

  2. Navigate to Settings in the main navigation menu.

  3. Your Account ID is displayed in the account or profile section. Note this numeric value, as you will need it when configuring the Nexla credential.

Generate a Personal Access Token​

Personal Access Tokens are the credentials used to authenticate API requests to Flexmail. Each token can be given a descriptive name so you can easily identify what it is used for.

  1. Sign in to your Flexmail account at flexmail.be.

  2. Navigate to Settings > API > Personal access tokens.

  3. Click Create new token.

  4. Enter a descriptive name for the token (for example, "Nexla Integration") to help identify its purpose later.

  5. Click Create (or the equivalent confirmation button) to generate the token.

Important

Copy the generated token immediately and store it in a secure location. Flexmail will not display the token value again after you navigate away from this page.

  1. Keep the token value ready to enter when configuring the Nexla credential below.

For additional details on Flexmail API authentication and personal access tokens, refer to the Flexmail API documentation.

Create a Flexmail Credential​

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

HTTP Basic Authentication Settings​

Flexmail uses HTTP Basic Authentication, which requires your Account ID and a Personal Access Token. These credentials authenticate all API requests made by Nexla on behalf of your Flexmail account.

  1. Enter your numeric Flexmail Account ID in the Account ID field. This is the numeric identifier for your Flexmail organization, used as the HTTP Basic Auth username.

  2. Enter your Flexmail Personal Access Token in the Personal Access Token field. This is the token generated under Settings > API > Personal access tokens in your Flexmail account, and it serves as the HTTP Basic Auth password. This field is treated as a secure/masked field.

    Personal Access Tokens provide full API access to your Flexmail account. Store tokens securely and avoid sharing them. If a token is compromised, revoke it immediately in your Flexmail account settings and generate a new one.

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.