Skip to main content

Authorization

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

Concord

Prerequisites​

The Concord connector authenticates to the ConcordNow REST API using an API key that is passed in the X-API-KEY request header. Before creating a credential in Nexla, you must generate an API key in your Concord account and identify the subdomain associated with your organization.

Obtain a Concord API Key​

API keys in Concord are generated from your account's integrations settings. Generating a key requires administrator privileges on the organization.

  1. Sign in to your Concord account at https://secure.concordnow.com (or your organization's dedicated environment URL).

  2. Click your account avatar or organization name, and open Automations (or Settings, depending on your plan).

  3. Navigate to Integrations > Concord API.

  4. Click Generate New Key to create a new API key.

  5. Copy the generated key immediately and store it in a secure location.

    Important

    The full API key value is typically displayed only once at the time of creation. Copy and store it securely before leaving the page, as you may not be able to view it again afterward.

API access and key generation are available on Concord plans that include API and integration features. For complete details on API availability, key management, and rotation, refer to the Getting Started with the Concord API guide and the Concord API reference.

Identify Your Subdomain​

The ConcordNow REST API is reached at a host that includes your account's subdomain—for example, an account at mycompany.concordnow.com uses the subdomain mycompany. Nexla constructs every API request URL using this subdomain, so it must match the environment where your data resides.

  • To find your subdomain, sign in to Concord and inspect the host portion of the URL in your browser's address bar. The text that appears before .concordnow.com is your subdomain.

Use the subdomain that corresponds to the environment you intend to connect to. Production and sandbox (UAT) environments use different hosts, so verify that the subdomain matches the account holding the agreements and data you want to access.

Create a Concord Credential​

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

Authentication Settings​

Concord uses API key authentication. The API key authenticates Nexla with the ConcordNow API on every request, and the subdomain determines which Concord environment Nexla connects to.

  1. Enter your Concord API key in the API Key Value field. This is the secret token generated in your Concord integrations settings, and it is passed in the X-API-KEY header of each request. This value is stored securely and should be kept confidential.

  2. Enter your account subdomain in the Subdomain / Environment field—for example, enter mycompany for an account at mycompany.concordnow.com. This value is required for all API endpoint URLs.

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.