HiBob

Sync employee data from HiBob HR platform.

Overview
Setup Guide
Permissions
Troubleshooting

Connect Parable to HiBob using a service user for automated HR data access.

People Data

Profiles, employment, org structure

Time & Attendance

Time off, attendance records

Data streams

This Provider Plugin defines 3 data streams.

Stream	Description	Sync
`employee`	All employees including inactive	full
`job_roles`	Job catalog roles	full
`position_budget`	Position budget entries	full

What You’ll Need

Credential	What it is
Service ID	Bob service user identifier
Token	Service user API token

Info: Setup access in HiBob. These steps require Administrator, or a colleague with equivalent permissions who can create credentials for you. If that is not you, ask your HiBob administrator.

Admin role in HiBob
Permission to create service users

Step 1: Access Service Users

Log in to HiBob as admin
Go to Settings → Integrations
Click Service Users

Step 2: Create Service User

Click Add Service User
Fill in:

Field	Value
Name	`Parable Integration`
Description	Integration user for Parable

Step 3: Configure Permissions

Grant read permissions for:

✅ People — Employee data
✅ Time Off — Leave data
✅ Reports — Report access
✅ Payroll — If needed

Warning: Only grant permissions for data you need to access.

Step 4: Generate Token

Click Create or Save
Copy the Service User ID
Generate and copy the Token

Warning: Store the token securely — it won’t be shown again!

Step 5: Enter values in the form

Enter Service User ID, Token, and Service URL in the Provider form.
Click Save & test connection.

Test Authentication

curl -H "Authorization: Basic BASE64_ENCODED(service_user_id:token)" \
  "https://api.hibob.com/v1/people"

Alternative Header Format

curl -H "id: YOUR_SERVICE_USER_ID" \
  -H "secret: YOUR_TOKEN" \
  "https://api.hibob.com/v1/people?limit=5"

Success: Success! If you received a 200 OK response with valid data, your credentials are configured correctly. You can now configure this Provider in Parable.

Tip: Rate Limits: HiBob enforces rate limits of rate limits apply; monitor response headers. Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.

Employee

Developer identifier: employeeEmployee. All employees including inactive.

Enables: Reconcile active and inactive HiBob employee records to work identity, organization, manager, site, and employment dates.
Scope: Reads the records selected by HiBob’s /v1/people/search operation as a snapshot stream using full synchronization. This stream is opt-in. Visibility follows the HiBob service user’s granted data categories and employee population. The stream does not include records the credential, parent traversal, configured filters, or provider API omits. A later complete read can treat a previously seen record that is absent as removed.

About

Developer identifier: employee.aboutAbout. About section. It preserves the nested context needed to interpret the parent employee.

Enables: Attribute about in employee.about to the parent employee; identify parent records where that nested about object is absent.
Interpretation: HiBob reports about as a nested object on each employee; optional children may be absent from a valid response.

Creation Date Time

Developer identifier: employee.creationDateTimeCreation Date Time. Record creation timestamp. It anchors the employee on the provider’s reported timeline.

Enables: Order Employee by creation date time in employee.creationDateTime and isolate records inside an exact provider reporting window.
Interpretation: HiBob reports creation date time as a timestamp on each employee; timezone and precision follow this API field, and absence is not an inferred event time.

Display Name

Developer identifier: employee.displayNameDisplay Name. Display name. It distinguishes the provider-defined display name state or classification for the employee.

Enables: Label each employee with display name from employee.displayName; distinguish records that share that display name but have different HiBob identifiers.
Interpretation: HiBob reports display name as display text for each employee; names are mutable and are not stable identities. A connector directive maps this field to a person’s display name.

Developer identifier: employee.emailEmail. Employee email address. It supplies the provider-reported address or location facet for the employee, not a residency determination.

Enables: Attribute each employee to a person or account by the exact email in employee.email; identify addresses that do not match the HiBob directory.
Interpretation: HiBob reports email as an address on each employee; aliases, casing, and unverified addresses can prevent a one-to-one person match. A connector directive maps this field to a person’s email identity.

First Name

Developer identifier: employee.firstNameFirst Name. First name. It gives the employee a human-readable provider label while its identifier remains the stable reference.

Enables: Label each employee with first name from employee.firstName; distinguish records that share that display name but have different HiBob identifiers.
Interpretation: HiBob reports first name as display text for each employee; names are mutable and are not stable identities.

Developer identifier: employee.idID. Unique employee identifier. It provides the reference needed to connect the employee to the corresponding provider object.

Enables: Match repeated employee entries on ID in employee.id; collapse only entries that share this declared transform key.
Interpretation: HiBob reports ID as an identifier in its employee namespace; it is not a universal identity outside HiBob. The connector explicitly marks this field as a transform deduplication key. A connector directive maps this field to account identity.

Internal

Developer identifier: employee.internalInternal. Internal HR fields including lifecycle status. It preserves the nested context needed to interpret the parent employee.

Enables: Attribute internal in employee.internal to the parent employee; identify parent records where that nested internal object is absent.
Interpretation: HiBob reports internal as a nested object on each employee; optional children may be absent from a valid response.

Lifecycle Status

Developer identifier: employee.internal.lifecycleStatusLifecycle Status. Current lifecycle status of the employee. It distinguishes the provider-defined lifecycle status state or classification for the HiBob employee internal.

Enables: Segment HiBob employee internal entries in Employee by lifecycle status in employee.HiBobEmployeeInternal.lifecycleStatus; compare counts only within the same HiBob taxonomy.
Interpretation: HiBob reports lifecycle status as a label from its own taxonomy on each HiBob employee internal; preserve unknown labels rather than mapping them by assumption.

Termination Date

Developer identifier: employee.internal.terminationDateTermination Date. Termination date if applicable. It anchors the employee on the provider’s reported timeline.

Enables: Order Employee by termination date in employee.HiBobEmployeeInternal.terminationDate and isolate records inside an exact provider reporting window.
Interpretation: HiBob reports termination date as a calendar date on each HiBob employee internal; its grain is one day and no time of day should be inferred.

Termination Reason

Developer identifier: employee.internal.terminationReasonTermination Reason. Reason for termination if applicable. It supplies the returned termination reason text needed to understand the HiBob employee internal in context.

Enables: Search the returned termination reason text in employee.HiBobEmployeeInternal.terminationReason and attribute each match to its parent employee and reported author when available.
Interpretation: HiBob supplies termination reason as returned text on each HiBob employee internal; truncation, formatting, and access boundaries can limit completeness.

Payroll

Developer identifier: employee.payrollPayroll. Payroll details. It preserves the nested context needed to interpret the parent employee.

Enables: Attribute payroll in employee.payroll to the parent employee; identify parent records where that nested payroll object is absent.
Interpretation: HiBob reports payroll as a nested object on each employee; optional children may be absent from a valid response.

Personal

Developer identifier: employee.personalPersonal. Personal details. It preserves the nested context needed to interpret the parent employee.

Enables: Attribute personal in employee.personal to the parent employee; identify parent records where that nested personal object is absent.
Interpretation: HiBob reports personal as a nested object on each employee; optional children may be absent from a valid response.

Surname

Developer identifier: employee.surnameSurname. Employee surname (HiBob wire key; not lastName). It supplies the surname profile facet used to reconcile or attribute the employee.

Enables: Reconcile the employee’s surname in employee.surname with its provider profile or directory identity; confirm ambiguous matches with the stable provider ID.
Interpretation: HiBob reports surname as a mutable profile or directory attribute on each employee; it may be absent, shared, or non-unique.

Work

Developer identifier: employee.workWork. Work details including title, department, and manager. It preserves the nested context needed to interpret the parent employee.

Enables: Attribute work in employee.work to the parent employee; identify parent records where that nested work object is absent.
Interpretation: HiBob reports work as a nested object on each employee; optional children may be absent from a valid response.

Custom

Developer identifier: employee.work.customCustom. Custom work fields. It preserves the nested context needed to interpret the parent employee.

Enables: Attribute custom in employee.HiBobEmployeeWork.custom to the parent employee; identify parent records where that nested custom object is absent.
Interpretation: HiBob reports custom as a nested object on each HiBob employee work; optional children may be absent from a valid response.

Department

Developer identifier: employee.work.departmentDepartment. Department name. It supplies the department profile facet used to reconcile or attribute the HiBob employee work.

Enables: Reconcile the employee’s department in employee.HiBobEmployeeWork.department with its provider profile or directory identity; confirm ambiguous matches with the stable provider ID.
Interpretation: HiBob reports department as a mutable profile or directory attribute on each HiBob employee work; it may be absent, shared, or non-unique.

Manager

Developer identifier: employee.work.managerManager. Manager display name. It identifies the related provider object that gives the HiBob employee work its parent, owner, or container context.

Enables: Connect each HiBob employee work to the related manager in employee.HiBobEmployeeWork.manager and verify that the referenced provider object resolves in the expected parent or container.
Interpretation: HiBob reports manager as relationship context on each HiBob employee work; resolve it in the named provider namespace rather than by display text alone.

Reports To

Developer identifier: employee.work.reportsToReports To. Reports-to reference. It preserves the nested context needed to interpret the parent employee.

Enables: Attribute reports to in employee.HiBobEmployeeWork.reportsTo to the parent employee; identify parent records where that nested reports to object is absent.
Interpretation: HiBob reports reports to as a nested object on each HiBob employee work; optional children may be absent from a valid response.

Site

Developer identifier: employee.work.siteSite. Work site or office location. It supplies the provider-reported address or location facet for the HiBob employee work, not a residency determination.

Enables: Group Employee by site in employee.HiBobEmployeeWork.site without treating that user, device, or request attribute as a data-residency signal.
Interpretation: HiBob reports site as a user, device, request, or resource location attribute on each HiBob employee work; it does not establish where data is stored or processed.

Start Date

Developer identifier: employee.work.startDateStart Date. Employment start date. It anchors the employee on the provider’s reported timeline.

Enables: Filter Employee by start date in employee.HiBobEmployeeWork.startDate; pair that boundary with the corresponding end before measuring elapsed time.
Interpretation: HiBob reports start date as a calendar date on each HiBob employee work; its grain is one day and no time of day should be inferred.

Tenure

Developer identifier: employee.work.tenureTenure. Tenure details. It preserves the nested context needed to interpret the parent employee.

Enables: Attribute tenure in employee.HiBobEmployeeWork.tenure to the parent employee; identify parent records where that nested tenure object is absent.
Interpretation: HiBob reports tenure as a nested object on each HiBob employee work; optional children may be absent from a valid response.

Title

Developer identifier: employee.work.titleTitle. Job title. It gives the HiBob employee work a human-readable provider label while its identifier remains the stable reference.

Enables: Label each HiBob employee work with title from employee.HiBobEmployeeWork.title; distinguish records that share that display name but have different HiBob identifiers.
Interpretation: HiBob reports title as display text for each HiBob employee work; names are mutable and are not stable identities.

Job Roles

Developer identifier: job_rolesJob Roles. Job catalog roles.

Enables: Verify the lifecycle and assignment of each HiBob job role.
Scope: Reads the records selected by HiBob’s /v1/job-catalog/job-roles operation as a snapshot stream using full synchronization. This stream is opt-in. Visibility follows the HiBob service user’s granted data categories and employee population. The stream does not include records the credential, parent traversal, configured filters, or provider API omits. A later complete read can treat a previously seen record that is absent as removed.

Job Role Description

Developer identifier: job_roles./jobRole/descriptionJob Role Description. Job role description. It preserves the nested context needed to interpret the parent job role.

Enables: Attribute job role description in job_roles./jobRole/description to the parent job role; identify parent records where that nested job role description object is absent.
Interpretation: HiBob reports job role description as a nested object on each job role; optional children may be absent from a valid response.

Human Readable

Developer identifier: job_roles./jobRole/description.humanReadableHuman Readable. Human-readable representation of the value when includeHumanReadable is set. It gives the HiBob path keyed value a human-readable provider label while its identifier remains the stable reference.

Enables: Display the human readable from job_roles.HiBobPathKeyedValue.humanReadable for each HiBob path keyed value; resolve duplicate or changed labels through the provider ID rather than the text.
Interpretation: HiBob supplies human readable as mutable display text on each HiBob path keyed value; it is not a stable identity.

Value

Developer identifier: job_roles./jobRole/description.valueValue. Raw field value (string, number, boolean, or object depending on field). It must be interpreted with the enclosing provider field name, type, or custom schema for the HiBob path keyed value.

Enables: Interpret job_roles.HiBobPathKeyedValue.value with the enclosing custom field name, declared type, and provider schema; compare only records that share that contract.
Interpretation: HiBob reports value under the enclosing custom or typed field contract on each HiBob path keyed value; compare it only with values from the same provider key and type.

Job Role ID

Developer identifier: job_roles./jobRole/idJob Role ID. Job role ID. It preserves the nested context needed to interpret the parent job role.

Enables: Match repeated job role entries on job role ID in job_roles./jobRole/id; collapse only entries that share this declared transform key.
Interpretation: HiBob reports job role ID as a nested object on each job role; optional children may be absent from a valid response. The connector explicitly marks this field as a transform deduplication key.

Job Role Name

Developer identifier: job_roles./jobRole/nameJob Role Name. Job role name. It preserves the nested context needed to interpret the parent job role.

Enables: Attribute job role name in job_roles./jobRole/name to the parent job role; identify parent records where that nested job role name object is absent.
Interpretation: HiBob reports job role name as a nested object on each job role; optional children may be absent from a valid response.

Position Budget

Developer identifier: position_budgetPosition Budget. Position budget entries.

Enables: Compare authorized position budget amounts by position, currency, pay period, and effective workforce-planning context.
Scope: Reads the records selected by HiBob’s /v1/positions/position-budget/search operation as a snapshot stream using full synchronization. This stream is opt-in. Visibility follows the HiBob service user’s granted data categories and employee population. Use is limited to authorized workforce and payroll reconciliation; the records are not invoices and do not support performance inference. A later complete read can treat a previously seen record that is absent as removed.

Position Budget Converted Total Cost Currency Value

Developer identifier: position_budget./positionBudget/convertedTotalCostCurrencyValuePosition Budget Converted Total Cost Currency Value. HiBob reports the position-budget attribute at /positionBudget/convertedTotalCostCurrencyValue. It preserves the nested context needed to interpret the parent position budget.

Enables: Attribute position budget converted total cost currency value in position_budget./positionBudget/convertedTotalCostCurrencyValue to the parent position budget; identify parent records where that nested position budget converted total cost currency value object is absent.
Interpretation: HiBob reports position budget converted total cost currency value as a nested object on each position budget; optional children may be absent from a valid response. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance. Any monetary amount is a provider HR or payroll record at its stated currency and pay basis, not an invoice.

Human Readable

Developer identifier: position_budget./positionBudget/convertedTotalCostCurrencyValue.humanReadableHuman Readable. Human-readable representation of the value when includeHumanReadable is set. It gives the HiBob path keyed value a human-readable provider label while its identifier remains the stable reference.

Enables: Display the human readable from position_budget.HiBobPathKeyedValue.humanReadable for each HiBob path keyed value; resolve duplicate or changed labels through the provider ID rather than the text.
Interpretation: HiBob supplies human readable as mutable display text on each HiBob path keyed value; it is not a stable identity. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance.

Value

Developer identifier: position_budget./positionBudget/convertedTotalCostCurrencyValue.valueValue. Raw field value (string, number, boolean, or object depending on field). It must be interpreted with the enclosing provider field name, type, or custom schema for the HiBob path keyed value.

Enables: Interpret position_budget.HiBobPathKeyedValue.value with the enclosing custom field name, declared type, and provider schema; compare only records that share that contract.
Interpretation: HiBob reports value under the enclosing custom or typed field contract on each HiBob path keyed value; compare it only with values from the same provider key and type. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance.

Position Budget Currency

Developer identifier: position_budget./positionBudget/CurrencyPosition Budget Currency. HiBob reports the position-budget attribute at /positionBudget/Currency. It preserves the nested context needed to interpret the parent position budget.

Enables: Attribute position budget currency in position_budget./positionBudget/Currency to the parent position budget; identify parent records where that nested position budget currency object is absent.
Interpretation: HiBob reports position budget currency as a nested object on each position budget; optional children may be absent from a valid response. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance. Any monetary amount is a provider HR or payroll record at its stated currency and pay basis, not an invoice.

Position Budget Expected Base Salary Currency Value

Developer identifier: position_budget./positionBudget/expectedBaseSalaryCurrencyValuePosition Budget Expected Base Salary Currency Value. HiBob reports the position-budget attribute at /positionBudget/expectedBaseSalaryCurrencyValue. It preserves the nested context needed to interpret the parent position budget.

Enables: Attribute position budget expected base salary currency value in position_budget./positionBudget/expectedBaseSalaryCurrencyValue to the parent position budget; identify parent records where that nested position budget expected base salary currency value object is absent.
Interpretation: HiBob reports position budget expected base salary currency value as a nested object on each position budget; optional children may be absent from a valid response. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance. Any monetary amount is a provider HR or payroll record at its stated currency and pay basis, not an invoice.

Position Budget Expected Variable Pay Currency Value

Developer identifier: position_budget./positionBudget/expectedVariablePayCurrencyValuePosition Budget Expected Variable Pay Currency Value. HiBob reports the position-budget attribute at /positionBudget/expectedVariablePayCurrencyValue. It preserves the nested context needed to interpret the parent position budget.

Enables: Attribute position budget expected variable pay currency value in position_budget./positionBudget/expectedVariablePayCurrencyValue to the parent position budget; identify parent records where that nested position budget expected variable pay currency value object is absent.
Interpretation: HiBob reports position budget expected variable pay currency value as a nested object on each position budget; optional children may be absent from a valid response. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance. Any monetary amount is a provider HR or payroll record at its stated currency and pay basis, not an invoice.

Position Budget ID

Developer identifier: position_budget./positionBudget/idPosition Budget ID. HiBob reports the position-budget attribute at /positionBudget/ID. It preserves the nested context needed to interpret the parent position budget.

Enables: Match repeated position budget entries on position budget ID in position_budget./positionBudget/id; collapse only entries that share this declared transform key.
Interpretation: HiBob reports position budget ID as a nested object on each position budget; optional children may be absent from a valid response. The connector explicitly marks this field as a transform deduplication key. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance. Any monetary amount is a provider HR or payroll record at its stated currency and pay basis, not an invoice.

Position Budget Pro Rated Cost Currency Value

Developer identifier: position_budget./positionBudget/proRatedCostCurrencyValuePosition Budget Pro Rated Cost Currency Value. HiBob reports the position-budget attribute at /positionBudget/proRatedCostCurrencyValue. It preserves the nested context needed to interpret the parent position budget.

Enables: Attribute position budget pro rated cost currency value in position_budget./positionBudget/proRatedCostCurrencyValue to the parent position budget; identify parent records where that nested position budget pro rated cost currency value object is absent.
Interpretation: HiBob reports position budget pro rated cost currency value as a nested object on each position budget; optional children may be absent from a valid response. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance. Any monetary amount is a provider HR or payroll record at its stated currency and pay basis, not an invoice.

Position Budget Salary Pay Period

Developer identifier: position_budget./positionBudget/salaryPayPeriodPosition Budget Salary Pay Period. HiBob reports the position-budget attribute at /positionBudget/salaryPayPeriod. It preserves the nested context needed to interpret the parent position budget.

Enables: Attribute position budget salary pay period in position_budget./positionBudget/salaryPayPeriod to the parent position budget; identify parent records where that nested position budget salary pay period object is absent.
Interpretation: HiBob reports position budget salary pay period as a nested object on each position budget; optional children may be absent from a valid response. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance. Any monetary amount is a provider HR or payroll record at its stated currency and pay basis, not an invoice.

Position Budget Total Position Cost Currency Value

Developer identifier: position_budget./positionBudget/totalPositionCostCurrencyValuePosition Budget Total Position Cost Currency Value. HiBob reports the position-budget attribute at /positionBudget/totalPositionCostCurrencyValue. It preserves the nested context needed to interpret the parent position budget.

Enables: Attribute position budget total position cost currency value in position_budget./positionBudget/totalPositionCostCurrencyValue to the parent position budget; identify parent records where that nested position budget total position cost currency value object is absent.
Interpretation: HiBob reports position budget total position cost currency value as a nested object on each position budget; optional children may be absent from a valid response. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance. Any monetary amount is a provider HR or payroll record at its stated currency and pay basis, not an invoice.

Position Budget Update Effective Date

Developer identifier: position_budget./positionBudget/updateEffectiveDatePosition Budget Update Effective Date. HiBob reports the position-budget attribute at /positionBudget/updateEffectiveDate. It preserves the nested context needed to interpret the parent position budget.

Enables: Attribute position budget update effective date in position_budget./positionBudget/updateEffectiveDate to the parent position budget; identify parent records where that nested position budget update effective date object is absent.
Interpretation: HiBob reports position budget update effective date as a nested object on each position budget; optional children may be absent from a valid response. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance. Any monetary amount is a provider HR or payroll record at its stated currency and pay basis, not an invoice.

Position Budget Variable Pay Period

Developer identifier: position_budget./positionBudget/variablePayPeriodPosition Budget Variable Pay Period. HiBob reports the position-budget attribute at /positionBudget/variablePayPeriod. It preserves the nested context needed to interpret the parent position budget.

Enables: Attribute position budget variable pay period in position_budget./positionBudget/variablePayPeriod to the parent position budget; identify parent records where that nested position budget variable pay period object is absent.
Interpretation: HiBob reports position budget variable pay period as a nested object on each position budget; optional children may be absent from a valid response. Use is limited to authorized workforce or payroll reconciliation and must not be used to infer employee performance. Any monetary amount is a provider HR or payroll record at its stated currency and pay basis, not an invoice.

Error	Meaning	Solution
`401 Unauthorized`	Invalid credentials	Verify ID and token
`403 Forbidden`	Missing permission	Add required permission to service user
`404 Not Found`	Resource doesn’t exist	Check endpoint path

HiBob API — Official API documentation

​People Data

​Time & Attendance

​Data streams

​HiBob

​What You’ll Need

​Step 1: Access Service Users

​Step 2: Create Service User

​Step 3: Configure Permissions

​Step 4: Generate Token

​Step 5: Enter values in the form