> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parable.work/llms.txt
> Use this file to discover all available pages before exploring further.

# HiBob

> Sync employee data from HiBob HR platform

Sync employee data from HiBob HR platform.

<Tabs>
  <Tab title="Overview">
    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 |
  </Tab>

  <Tab title="Setup Guide">
    ### HiBob

    #### 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

    1. Log in to HiBob as admin
    2. Go to **Settings** → **Integrations**
    3. Click **Service Users**

    #### Step 2: Create Service User

    1. Click **Add Service User**
    2. 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

    1. Click **Create** or **Save**
    2. Copy the **Service User ID**
    3. Generate and copy the **Token**

    > **Warning:** Store the token securely — it won't be shown again!

    #### Step 5: Enter values in the form

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

    ```bash Test Authentication theme={null}
    curl -H "Authorization: Basic BASE64_ENCODED(service_user_id:token)" \
      "https://api.hibob.com/v1/people"
    ```

    ```bash Alternative Header Format theme={null}
    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.
  </Tab>

  <Tab title="Permissions">
    <AccordionGroup>
      <Accordion id="provider-permission-tap-hibob-employee-6aa67fb697d4" title="Employee" icon="people-group" iconType="sharp-duotone-solid">
        Developer identifier: `employee`

        **Employee.** 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.

        <AccordionGroup>
          <Accordion id="provider-permission-field-hibob-employee-about-faaaddf8f8a2" title="About" icon="terminal" iconType="sharp-duotone-solid">
            Developer identifier: `employee.about`

            **About.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-creationdatetime-a7f82e99cf64" title="Creation Date Time" icon="location-crosshairs" iconType="sharp-duotone-solid">
            Developer identifier: `employee.creationDateTime`

            **Creation 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-displayname-d9822db9115a" title="Display Name" icon="map-location-dot" iconType="sharp-duotone-solid">
            Developer identifier: `employee.displayName`

            **Display 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-email-b322a552298d" title="Email" icon="envelope" iconType="sharp-duotone-solid">
            Developer identifier: `employee.email`

            **Email.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-firstname-3b2e355756ba" title="First Name" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `employee.firstName`

            **First 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-id-4bcfc3486165" title="ID" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `employee.id`

            **ID.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-internal-a30758bb9cc3" title="Internal" icon="calendar-clock" iconType="sharp-duotone-solid">
            Developer identifier: `employee.internal`

            **Internal.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-internal-lifecyclestatus-7444f046692d" title="Lifecycle Status" icon="earth-americas" iconType="sharp-duotone-solid">
            Developer identifier: `employee.internal.lifecycleStatus`

            **Lifecycle 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-internal-terminationdate-0560573edb45" title="Termination Date" icon="calendar-days" iconType="sharp-duotone-solid">
            Developer identifier: `employee.internal.terminationDate`

            **Termination 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-internal-terminationreason-6041599beb77" title="Termination Reason" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `employee.internal.terminationReason`

            **Termination 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-payroll-d94ee8fc8cc4" title="Payroll" icon="code-commit" iconType="sharp-duotone-solid">
            Developer identifier: `employee.payroll`

            **Payroll.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-personal-96b2df3742d3" title="Personal" icon="terminal" iconType="sharp-duotone-solid">
            Developer identifier: `employee.personal`

            **Personal.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-surname-61cbe56b6297" title="Surname" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `employee.surname`

            **Surname.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-work-51a49695f7c3" title="Work" icon="code-branch" iconType="sharp-duotone-solid">
            Developer identifier: `employee.work`

            **Work.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-work-custom-306e0ed5916a" title="Custom" icon="brackets-curly" iconType="sharp-duotone-solid">
            Developer identifier: `employee.work.custom`

            **Custom.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-work-department-ed11f6e67153" title="Department" icon="id-card" iconType="sharp-duotone-solid">
            Developer identifier: `employee.work.department`

            **Department.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-work-manager-afb00c9d0a44" title="Manager" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `employee.work.manager`

            **Manager.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-work-reportsto-dec85c169b7b" title="Reports To" icon="code-branch" iconType="sharp-duotone-solid">
            Developer identifier: `employee.work.reportsTo`

            **Reports 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-work-site-467a1c1f61ac" title="Site" icon="globe" iconType="sharp-duotone-solid">
            Developer identifier: `employee.work.site`

            **Site.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-work-startdate-9a742a012e42" title="Start Date" icon="calendar-clock" iconType="sharp-duotone-solid">
            Developer identifier: `employee.work.startDate`

            **Start 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-work-tenure-4fed2157c10a" title="Tenure" icon="code-branch" iconType="sharp-duotone-solid">
            Developer identifier: `employee.work.tenure`

            **Tenure.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-employee-work-title-c039ae957e87" title="Title" icon="address-book" iconType="sharp-duotone-solid">
            Developer identifier: `employee.work.title`

            **Title.** 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.
          </Accordion>
        </AccordionGroup>
      </Accordion>

      <Accordion id="provider-permission-tap-hibob-job-roles-dfbbf552b51d" title="Job Roles" icon="shield-check" iconType="sharp-duotone-solid">
        Developer identifier: `job_roles`

        **Job 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.

        <AccordionGroup>
          <Accordion id="provider-permission-field-hibob-job-roles-jobrole-description-6a831652d9b2" title="Job Role Description" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `job_roles./jobRole/description`

            **Job 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-job-roles-jobrole-description-humanreadabl-7156d2b9ddad" title="Human Readable" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `job_roles./jobRole/description.humanReadable`

            **Human 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-job-roles-jobrole-description-value-41f370071247" title="Value" icon="shield-check" iconType="sharp-duotone-solid">
            Developer identifier: `job_roles./jobRole/description.value`

            **Value.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-job-roles-jobrole-id-62288c8d9f6a" title="Job Role ID" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `job_roles./jobRole/id`

            **Job 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-job-roles-jobrole-name-00f8366c8fe8" title="Job Role Name" icon="shield-check" iconType="sharp-duotone-solid">
            Developer identifier: `job_roles./jobRole/name`

            **Job 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.
          </Accordion>
        </AccordionGroup>
      </Accordion>

      <Accordion id="provider-permission-tap-hibob-position-budget-d0e490d34cba" title="Position Budget" icon="cubes" iconType="sharp-duotone-solid">
        Developer identifier: `position_budget`

        **Position 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.

        <AccordionGroup>
          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-convertedto-2fb3b25f9728" title="Position Budget Converted Total Cost Currency Value" icon="shield-check" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/convertedTotalCostCurrencyValue`

            **Position 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-convertedto-761137ec8186" title="Human Readable" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/convertedTotalCostCurrencyValue.humanReadable`

            **Human 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-convertedto-fbb514a663f5" title="Value" icon="shield-check" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/convertedTotalCostCurrencyValue.value`

            **Value.** 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-currency-0a0bf8780363" title="Position Budget Currency" icon="user-shield" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/Currency`

            **Position 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-expectedbas-832f84e46d8d" title="Position Budget Expected Base Salary Currency Value" icon="badge-check" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/expectedBaseSalaryCurrencyValue`

            **Position 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-expectedvar-06ba945d5c35" title="Position Budget Expected Variable Pay Currency Value" icon="badge-check" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/expectedVariablePayCurrencyValue`

            **Position 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-id-88bd52e5ff77" title="Position Budget ID" icon="unlock" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/id`

            **Position 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-proratedcos-ddb83eb4b7b4" title="Position Budget Pro Rated Cost Currency Value" icon="lock" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/proRatedCostCurrencyValue`

            **Position 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-salarypaype-e94b84a48549" title="Position Budget Salary Pay Period" icon="shield-check" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/salaryPayPeriod`

            **Position 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-totalpositi-0524dd08a46e" title="Position Budget Total Position Cost Currency Value" icon="lock" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/totalPositionCostCurrencyValue`

            **Position 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-updateeffec-f3cccdb7fb76" title="Position Budget Update Effective Date" icon="lock" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/updateEffectiveDate`

            **Position 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.
          </Accordion>

          <Accordion id="provider-permission-field-hibob-position-budget-positionbudget-variablepay-0dcbc0f75f50" title="Position Budget Variable Pay Period" icon="passport" iconType="sharp-duotone-solid">
            Developer identifier: `position_budget./positionBudget/variablePayPeriod`

            **Position 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.
          </Accordion>
        </AccordionGroup>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Troubleshooting">
    | 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](https://apidocs.hibob.com/)** — Official API documentation
  </Tab>
</Tabs>