Skip to main content

Authorization

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

Groove

Prerequisites​

To connect Nexla to Groove, you need an active Groove account with administrator access and a Groove API key. The Groove API uses Bearer token authentication — your API key is passed as a Bearer token in the Authorization header of every request.

Generate a Groove API Key​

Groove API keys are generated from your account settings. You must have administrator permissions to access the API settings section.

  1. Sign in to your Groove account at groovehq.com.

  2. Click your account avatar or name in the upper-right corner, and select Settings from the dropdown menu.

  3. In the left navigation panel, scroll to the Developer section and click API.

  4. Click the Generate Token button (or Create New Token if you have existing tokens) to create a new API key.

  5. Copy the generated API token immediately and store it securely. This is your API key value that you will enter in Nexla.

Your API key grants access to your Groove account data. Store it securely and avoid sharing it. Groove tokens expire one year from the date of creation, or when manually revoked. Generate a new token before expiry to avoid interruptions in your Nexla data flows. For complete information about Groove API authentication, visit the Groove API documentation.

Create a Groove Credential​

  • To create a new Groove 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 Configuration​

  1. Enter your Groove API key in the API Key Value field. This is the Bearer token generated in your Groove account settings (see Generate a Groove API Key above). Nexla will send this value as a Bearer token in the Authorization header of all API requests to Groove.
Important

The API Key Value field is a password-type field — the value will be masked after entry. Ensure you have copied the correct token from your Groove account settings before saving.

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.