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

# Service User

> Connect Parable to HiBob using a service user

export const platform_1 = "HiBob"

export const limit_0 = "rate limits apply; monitor response headers"

export const platform_0 = "HiBob"

export const role_0 = undefined

<Tabs>
  <Tab title="Setup">
    <Card title="What You'll Need" icon="key">
      | Credential     | What it is                  |
      | -------------- | --------------------------- |
      | **Service ID** | Bob service user identifier |
      | **Token**      | Service user API token      |
    </Card>

    ## Overview

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

    <CardGroup cols={2}>
      <Card title="People Data" icon="users">
        Profiles, employment, org structure
      </Card>

      <Card title="Time & Attendance" icon="clock">
        Time off, attendance records
      </Card>
    </CardGroup>

    ## Prerequisites

    <Info>
      **Setup access in {platform_0}.** These steps require **{role_0}**, or a colleague with equivalent permissions who can create credentials for you.

      If that is not you, ask your {platform_0} administrator.
    </Info>

    * **Admin** role in HiBob
    * Permission to create service users

    ## Setup Guide

    <Steps>
      <Step title="Access Service Users">
        1. Log in to HiBob as admin
        2. Go to **Settings** → **Integrations**
        3. Click **Service Users**
      </Step>

      <Step title="Create Service User">
        1. Click **Add Service User**
        2. Fill in:

        | Field       | Value                        |
        | ----------- | ---------------------------- |
        | Name        | `Parable Integration`        |
        | Description | Integration user for Parable |
      </Step>

      <Step title="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.
        </Warning>
      </Step>

      <Step title="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!
        </Warning>
      </Step>

      <Step title="Enter values in the form">
        1. Enter **Service User ID**, **Token**, and **Service URL** in the connector form.
        2. Click **Save & test connection**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Reference">
    ## Verify Your Setup

    <CodeGroup>
      ```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"
      ```
    </CodeGroup>

    <Check>
      **Success!** If you received a `200 OK` response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.
    </Check>

    <Tip>
      **Rate Limits:** {platform_1} enforces rate limits of **{limit_0}**.

      Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.
    </Tip>

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

    ## Additional Resources

    <CardGroup cols={2}>
      <Card title="HiBob API" icon="book" href="https://apidocs.hibob.com/">
        Official API documentation
      </Card>
    </CardGroup>
  </Tab>
</Tabs>