Skip to main content

HoorayHR

HoorayHR is an all-in-one HR platform built for small and medium-sized businesses. It centralizes the full employee lifecycle—digital personnel files, leave and absence management, timesheets, contract signing, onboarding workflows, HR analytics, and employee development—in a single, ISO 27001-certified solution. Organizations use HoorayHR to streamline day-to-day HR operations, reduce administrative overhead, and give employees self-service access via a mobile app. The platform integrates with payroll systems such as Nmbrs, AFAS Software, and Exact Online, and exposes a REST API so that HR data can be consumed by external tools, reporting platforms, and data pipelines.

HoorayHR icon

Power end-to-end data operations for your HoorayHR API with Nexla. Our bi-directional HoorayHR connector is purpose-built for HoorayHR, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to HoorayHR or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your HoorayHR workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

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.

Authenticate​

Create a credential in Nexla​

  1. After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

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

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

  5. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation.

Use as a data source​

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the HoorayHR connector tile, then select the credential that will be used to connect to the HoorayHR instance, and click Next; or, create a new HoorayHR credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common HoorayHR endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Users

This endpoint retrieves all employee (user) records from your HoorayHR account. Use this endpoint when you need to access employee profile data for reporting, analytics, or synchronization with other systems. The response includes personal information, contact details, employment dates, job titles, and organizational assignments for each employee.

  • This endpoint automatically retrieves all employees accessible to the authenticated account. No additional parameters are required beyond selecting this template—Nexla will fetch all records from the HoorayHR /users endpoint using GET requests.
  • The HoorayHR Users endpoint returns comprehensive employee records. Common fields include employee ID, name, email address, employment start date, job title, department, and manager assignment. Use Nexla's schema and transformation tools to map these fields to your target system's requirements.

The data accessible through this endpoint is determined by the permissions of the HoorayHR account used in the credential. Ensure the account has HR manager or administrator access to retrieve records for all employees in your organization.

Time Off

This endpoint retrieves all leave request records from your HoorayHR account. Use this endpoint to access time-off data for HR reporting, payroll processing, workforce planning, or compliance auditing. Each record includes the employee, leave dates, leave type, approval status, approver details, and budget impact information.

  • This endpoint automatically retrieves all time-off records accessible to the authenticated account. No additional parameters are required—Nexla fetches all leave requests from the HoorayHR /time-off endpoint using GET requests.

  • Time-off records in HoorayHR capture the full lifecycle of each leave request, including:

    • The requesting employee and submission date
    • Start and end dates of the leave period
    • Leave type (linked to the leave type configuration)
    • Approval status and approver identity
    • Budget tracking information showing days deducted from leave balances

To enrich time-off records with leave type details such as category name and accrual rules, combine this endpoint with the Leave Types endpoint in a multi-source Nexla flow.

Leave Types

This endpoint retrieves the leave type configuration records defined in your HoorayHR account. Use this endpoint when you need to understand the categories of leave available to employees, their accrual rules, budget allocations, and calculation methods. This data is useful for building HR analytics dashboards or synchronizing leave policies with external payroll or scheduling systems.

  • This endpoint automatically retrieves all leave type configurations from the HoorayHR /leave-types endpoint. No additional parameters are required.

  • Leave type records include configuration details such as:

    • Leave type name and identifier
    • Budget allocation rules (e.g., annual entitlement in days)
    • Accrual calculation method (calendar year, employment anniversary, etc.)
    • Whether the leave type is paid or unpaid
    • Any carry-over or expiration policies defined in HoorayHR

Leave type configurations in HoorayHR are managed by HR administrators. Changes to leave type rules in HoorayHR are reflected in subsequent API responses. Re-run this data source after policy changes to keep your downstream systems up to date.

Sick Leaves

This endpoint retrieves absence (sick leave) records from your HoorayHR account. Use this endpoint when you need to access employee absenteeism data for HR reporting, occupational health tracking, payroll processing, or compliance with labor regulations. Records include reported and actual absence dates, return-to-work information, and approval details.

  • This endpoint automatically retrieves all sick-leave records accessible to the authenticated account from the HoorayHR /sick-leave endpoint. No additional parameters are required.

  • Sick-leave records in HoorayHR capture both the employee-reported absence and any administrative updates, including:

    • The employee and the date the absence was reported
    • The reported start date and the actual start date of the absence (which may differ)
    • The return-to-work date once the employee is back
    • Approval status and responsible HR contact
    • Any notes or follow-up actions recorded in HoorayHR

Sick-leave data may be subject to privacy and data protection regulations (such as GDPR) in your jurisdiction. Ensure that your Nexla flows handle this sensitive data in compliance with your organization's data governance policies and applicable law.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration​

HoorayHR data sources can also be manually configured to ingest data from any valid HoorayHR API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

HoorayHR's REST API base URL is https://api.hooray.nl. Common endpoint paths include /users (employee records), /time-off (leave requests), /leave-types (leave type configurations), and /sick-leave (absence records)—enter the complete URL including base URL and path, for example https://api.hooray.nl/users. You do not need to include the Authorization header; Nexla injects the Bearer token obtained from the HoorayHR authentication endpoint automatically based on the credential configuration. The complete HoorayHR API reference, including all available endpoints, request parameters, and response schemas, is available in the HoorayHR API documentation.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new HoorayHR data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.