Skip to main content

Authorization

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

HoorayHR

Prerequisites​

HoorayHR authenticates API requests using a session token that is obtained by submitting valid account credentials to the HoorayHR authentication endpoint. Nexla handles this token exchange automatically—you only need to provide your HoorayHR username and password when creating the credential.

HoorayHR Account Requirements​

Before creating the credential in Nexla, confirm the following:

  • You have an active HoorayHR account with access to the data you want to integrate. Administrative or HR manager roles typically provide the broadest data access.

  • Multi-Factor Authentication (MFA) must be disabled on the account used for API access. The HoorayHR API does not support MFA during session token authentication. Use a dedicated service account or integration user rather than a personal account to minimize disruption if credentials need to be rotated.

  • The account must have the appropriate permissions to access the resources you intend to use (employees, time-off records, leave types, and sick-leave records).

HoorayHR recommends creating a dedicated integration user for API access rather than using a personal employee account. This practice improves security, simplifies credential rotation, and avoids disrupting individual users. Contact your HoorayHR administrator to create an integration user account if needed.

Locating Your HoorayHR Credentials​

Your HoorayHR username is the email address associated with your HoorayHR account. Your password is the password you use to sign in to the HoorayHR web application at hoorayhr.io. No additional API keys or developer portal setup is required—the API uses standard account credentials.

For additional information about account management and user permissions, refer to the HoorayHR API documentation.

Create a HoorayHR Credential​

  • To create a new HoorayHR credential, after selecting the data source 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​

HoorayHR uses username and password credentials to obtain a session-based Bearer token. Nexla exchanges these credentials for a token automatically when establishing a connection.

  1. Enter your HoorayHR account email address in the Username field. This is the email address you use to sign in to the HoorayHR web application.

  2. Enter your HoorayHR account password in the Password field. This value is stored securely and is used only to obtain a session token from the HoorayHR authentication endpoint (https://api.hooray.nl/authentication).

Important

Ensure that Multi-Factor Authentication (MFA) is disabled on the HoorayHR account you are using for API access. If MFA is enabled, the authentication request will fail and the credential cannot be saved successfully.

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 creation and can be selected for use with a new data source.