Skip to main content

Authorization

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

Emma

Prerequisites​

Before creating an Emma credential, you need to obtain an API Key Value and Account ID from your Emma account. Both values are required to authenticate with the Emma API.

To obtain your API Key Value and Account ID, you need to have an Emma account with API access enabled. Once you have access to your account, you can generate an API key and find your Account ID from your Emma account settings. The API Key Value is used to authenticate all API requests to the Emma API. The API Key Value is sent in the Authorization header for all API requests. The Account ID is used to construct the API base URL for your account. For detailed information about API key setup and authentication, refer to the Emma API documentation.

Create an Emma Credential​

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

New Credential Overlay – Emma

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

API Key Value​

  1. Enter your Emma API Key Value in the API Key Value field. This is the API key you obtained from your Emma account settings. The API Key Value is sent in the Authorization header for all API requests to the Emma API.

    Keep your API Key Value secure and do not share it publicly. The API Key Value provides access to your Emma account and should be treated as sensitive information. The API Key Value is sent in the Authorization header for all API requests to the Emma API. For detailed information about obtaining and managing API keys, see the Emma API documentation.

Account ID​

  1. Enter your Emma Account ID in the Account Id field. This is the unique identifier for your Emma account. The Account ID is used to construct the API base URL for your account (e.g., https://api.e2ma.net/{account_id}).

    The Account ID is the unique identifier for your Emma account. The Account ID is used to construct the API base URL for your account, which is used in all API requests. You can find your Account ID in your Emma account settings. For detailed information about finding your Account ID, see the Emma 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.