bob HR Connector

Embed bob HR to sync employee records, automate onboarding, surface time-off and tasks, and trigger per-customer workflows with reusable Cyclr templates and multi-tenant orchestration.

Build with this Connector Talk to an integration expert

Ship customer integrations faster

Prebuilt templates accelerate delivery to customers.

Reusable orchestration

Copy, customize and version integration templates per customer.

Event-driven sync

Use bob webhooks to trigger reliable workflows.

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

Overview

Teams can integrate or automate employee lifecycle data, time-off requests, tasks, documents, hiring records and workforce planning between bob HR and other systems. Cyclr lets product teams embed those integrations in-app, manage per-customer installations, handle token rotation and subscribe to bob webhooks for near-real-time event-driven flows.

PRODUCT USE CASES

Use cases

Build repeatable templates for common HR workflows — bulk employee syncs, onboarding document pushes, time-off approvals, and hiring data exports — then clone and customize those templates per customer to accelerate delivery and reduce maintenance.

Provision and update employee records

Create or update employee records in bob HR from your app; use People API reads to keep customer accounts synchronized.

Push onboarding documents and tasks

Create employee documents and onboarding tasks in bob Docs and Tasks modules when a customer provisions a new hire.

Surface and sync time-off requests

Subscribe to Time off webhooks and reflect requests and approvals into your product or payroll systems.

ORCHESTRATION

How bob HR works with Cyclr

Cyclr sits between your SaaS product and bob HR to handle authentication, govern access and orchestrate every API call per customer, at scale.

1
Your SaaS product
Your app requests an action for a specific customer.
2
Cyclr orchestration
Cyclr authenticates, applies policies and routes the request.
3
bob HR
bob HR processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore bob HR methods you can orchestrate through Cyclr.

Time Off15

List Who Is Out On Day

Action

Returns the list of people that have a time off request today or on the specified date.

List Who Is Out

Action

Read a list of who's out of the office.

List Updated Time Off Requests

Action

Returns the list of time off requests that are pending, approved or cancelled since the specified date.

Submit Timeoff Request

Action

Submits a new time off request.

Cancel Timeoff Request

Action

Cancels an existing time off request.

Get Employee Balance

Action

Retrieve the balance for a given employee, for a given policy type, as of a given date.

Get Time Off Request

Action

Supplies detailed info about an existing time off request.

Submit Timeoff Request (Different Hrs Per Day)

Action

Submits a new timeoff request of different hours per day.

Create Balance Adjustment

Action

Create a balance adjustment for a given employee for a given effective date.

Create Policy Reason Codes

Action

Add a list of reason codes for a given policy type.

List Policy Types

Action

Get a list of all policy type names.

List Policy Type Reason Codes

Action

Get list of reason codes for a given policy type.

Get Policy

Action

Get details about a given policy.

List Policy Names

Action

Get a list of policy names for the user's defined policy type.

Get Policy Type

Action

Get details about a given policy type.

People10

Update Persons Start Date

Action

Set or update an employee's start date.

Create Person

Action

This creates a new employee record in Bob.

Search People

Action

Returns a list of requested employees, data is filtered based on the access level of the logged-in user.

Get Person

Action

Return the detatils of the specified person.

Update Persons Email

Action

Set or update an employee's email address.

List Public Profiles

Action

Returns the public section of all active employees of the logged-in user company.

List Persons Salary History

Action

Returns a list of salary history entries for a given employee.

Import Attendance Data

Action

Import Attendance Data for employee.

List Persons Variable Payments

Action

Returns a list of variable payments for a given employee.

Create Salary Entry

Action

Creates a new salary entry for a given employee.

Documents2

Upload to Employee's Shared Folder

Action

Upload a file to the employee's shared folder.

Upload to Employee's Private Folder

Action

Upload a file to the employee's shared folder.

Departments1

List Departments

Action

Return a list of all departments.

Named Lists1

List All Named Lists

Action

List all named lists.

People Custom Tables (Enhanced)1

List People Custom Table Entries

Action

Returns all entries on the table for the speciifed person.

People Custom Tables2

List People Custom Tables

Action

List all custom tables.

List People Custom Table Entries

Action

Returns all entries on the table for the speciifed person.

Named Lists (Enhanced)1

Get Named List

Action

Get a named list.

Sites1

List All Sites

Action

List Sites.

Payroll1

List Payroll History

Action

Retrieve the balance for a given employee, for a given policy type, as of a given date.

Webhooks8

Employee Updated (V1)

Webhook

Triggered when an employee is updated.

Employee Created (V2)

Webhook

Triggered when an employee is created.

Employee Joined (V2)

Webhook

Triggered when employee start date has occurred.

Employee Left (V2)

Webhook

Triggered when employee termination date has occurred.

Employee Updated (V2)

Webhook

Triggered when an employee is updated.

Employee Created (V1)

Webhook

Triggered when an employee is created.

Employee Joined (V1)

Webhook

Triggered when employee start date has occurred.

Employee Left (V1)

Webhook

Triggered when employee termination date has occurred.

TECHNICAL DETAILS

bob HR integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing bob HR integrations in Cyclr.

API and authentication

API host: https://api.hibob.com/v1
Authentication: OAuth 2.0 (Marketplace apps) and Service Users (Basic Auth)
Credentials: OAuth: client_id, client_secret, redirect_uri. Service Users: service_user_id and service_user_token.
Method categories: Read, search, create, update employee data; bulk read endpoints; webhooks; cursor and no-pagination endpoints.

View vendor API documentation →

Pagination and rate limits

Pagination

Some endpoints use cursor-based pagination; others (people/search bulk reads) return all matches in one call with no pagination. Check each endpoint contract for details.

Rate limits

HiBob applies per-endpoint limits (for example people/search example: 50 requests/min) and returns X-RateLimit headers; WAF-based blocking applies on repeated auth failures.

IMPLEMENTATION

Authentication at a glance

Marketplace partners use OAuth 2.0 Authorization Code; customer-built integrations commonly use Service Users with Basic Auth. Access tokens expire quickly and require refresh or rotation handling.

Authentication method: OAuth 2.0 (Marketplace apps) and Service Users (Basic Auth)
Credential required: OAuth: client_id, client_secret, redirect_uri. Service Users: service_user_id and service_user_token.

Before you begin:

OAuth apps require HiBob Marketplace approval; Service Users must be created by a HiBob admin and given explicit permissions.

View setup guide

COMMON QUESTIONS

Frequently asked questions

It synchronizes employee lifecycle data, time-off requests, tasks, documents, hiring and workforce planning records between bob HR and other systems, and can trigger workflows from bob webhooks.

Use OAuth 2.0 Authorization Code for Marketplace partner apps or Service Users (Basic Auth) for customer-built integrations; access tokens expire quickly and refresh or rotation is required.

Yes. Use OAuth partner installs or map Service User credentials per customer and Cyclr’s multi-tenant templates to manage per-customer provisioning and permissions.

Yes. Cyclr workflows can expose bob API actions as governed MCP tools with tenant scoping, permission controls and reusable templates for auditability.

KEEP EXPLORING

Related resources and connectors

Documentation

bob HR Connector

Ship customer integrations faster

Reusable orchestration

Event-driven sync

Embedded experience

Overview

Use cases

Provision and update employee records

Push onboarding documents and tasks

Surface and sync time-off requests

How bob HR works with Cyclr

Your SaaS product

Cyclr orchestration

bob HR

Available connector capabilities

List Who Is Out On Day

List Who Is Out

List Updated Time Off Requests

Submit Timeoff Request

Cancel Timeoff Request

Get Employee Balance

Get Time Off Request

Submit Timeoff Request (Different Hrs Per Day)

Create Balance Adjustment

Create Policy Reason Codes

List Policy Types

List Policy Type Reason Codes

Get Policy

List Policy Names

Get Policy Type

Update Persons Start Date

Create Person

Search People

Get Person

Update Persons Email

List Public Profiles

List Persons Salary History

Import Attendance Data

List Persons Variable Payments

Create Salary Entry

Upload to Employee's Shared Folder

Upload to Employee's Private Folder

List Departments

List All Named Lists

List People Custom Table Entries

List People Custom Tables

List People Custom Table Entries

Get Named List

List All Sites

List Payroll History

Employee Updated (V1)

Employee Created (V2)

Employee Joined (V2)

Employee Left (V2)

Employee Updated (V2)

Employee Created (V1)

Employee Joined (V1)

Employee Left (V1)

bob HR integration and API details

API and authentication

Pagination and rate limits

Pagination

Rate limits

Authentication at a glance

Frequently asked questions

Related resources and connectors

HR Integrations to make your daily tasks easier

What is iPaaS?

MCP PaaS

BambooHR

Breathe HR

Bullhorn

Let Cyclr handle the integrations.