Skip to main content

Authorization

Follow this guide to create a new Height credential that will allow Nexla to authenticate to and exchange data with your Height workspace.
height_api_auth.png

Height

Prerequisites​

To connect Nexla to Height, you will need a Height API secret key. The Height API uses API key authentication — all requests are authenticated by passing your secret key in the Authorization request header using the format api-key <your-secret-key>.

Obtain a Height API Secret Key​

Height API keys are personal access tokens tied to your Height user account and workspace. They are generated from within the Height application settings.

  1. Sign in to your Height workspace at height.app.

  2. Click your workspace name or avatar in the top-left corner to open the workspace menu.

  3. Navigate to Settings in the workspace menu.

  4. In the Settings panel, select the API section.

  5. Your API secret key is displayed in the API section. Click Copy to copy the key to your clipboard.

    Height API keys are tied to your individual user account. Any API requests made using this key will be performed with the same permissions as your Height user account. Ensure the account used to generate the key has the appropriate access to the workspace resources you intend to read from or write to.

  6. Store the copied secret key in a secure location. Treat it like a password — do not share it in publicly accessible code repositories or other unsecured environments.

Important

Height API keys provide full access to your Height workspace data on behalf of the associated user account. Rotate or revoke the key from Settings > API in Height if it is ever compromised or no longer needed.

For additional reference, see the Height API documentation.

Create a Height Credential​

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

API Key​

Height uses API Key authentication. All requests to the Height API are made over HTTPS to the base URL https://api.height.app, and the secret key is passed in the Authorization header in the format api-key <your-secret-key>.

  1. Enter your Height API secret key in the Secret Key field. This is the key you copied from Settings > API in your Height workspace. Nexla will include this key in the Authorization header of every request sent to the Height API.

    The Height API enforces a rate limit of 120 requests per minute on most endpoints. Some endpoints, such as task creation and activity posting, have a stricter limit of 60 requests per minute. If your data flows generate a high volume of API calls, consider spacing out requests or using Nexla's scheduling options to stay within these limits. Requests that exceed the rate limit will receive a 429 Too Many Requests response.

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.