Bob API

Name: Bob API API
Brand: Bob API
Availability: InStock

★ Only Publicly Available SpecHR recruitingEmployee ManagementapiKey, basic94 EndpointsREST

For Agents

Manage HiBob employees, onboarding, time-off, attendance, custom fields, and reports through 94 endpoints with token or Basic authentication, including a sandbox host.

Quickstart

Get started with Bob API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"list employees who are out of office today"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Bob API API.

Search employees with rich filters via POST /people/search and read details via GET /people/{identifier}

Create, update, terminate, and uninvite employees through the /people and /employees endpoints

Onboard new hires by setting start dates and sending welcome wizards via POST /employees/{employeeId}/invitations

Submit, retrieve, and cancel time-off requests and read who's-out lists for a given date

GET STARTED

Start building with Bob API API

Explore with Jentic

View OpenAPI Spec

Use for: Search for all employees in the Engineering department, Create a new employee record with start date 2026-09-01, Submit a time-off request for employee 1234 from 2026-08-15 to 2026-08-22, Get the list of employees who are out of the office today

Not supported: Does not handle payroll processing, benefits enrollment, or applicant tracking — use for HiBob employee records, time-off, attendance, and HR reports only.

Jentic publishes the only available OpenAPI specification for Bob API, keeping it validated and agent-ready.

The Bob API is HiBob's HR platform interface for managing employees, onboarding, time-off, attendance, reports, and company configuration. Across 94 endpoints, integrators can search and read employees, create and terminate employees, set start dates and welcome wizards, manage avatars and tasks, configure custom fields and named lists, submit and inspect time-off requests, query who's-out today, and import attendance. Authentication accepts a Bearer-style API token in the Authorization header or HTTP Basic for service users, and a sandbox host (api.sandbox.hibob.com) is available for testing.

Use Cases

Patterns agents use Bob API API for, with concrete tasks.

★ Joiner-Mover-Leaver Automation

HRIS automations create new employees with POST /people, set their start date via POST /employees/{employeeId}/start-date, and trigger welcome wizards through POST /employees/{employeeId}/invitations. When someone leaves, POST /employees/{identifier}/terminate handles the termination workflow and POST /employees/{identifier}/uninvite revokes Bob access. This collapses what is typically a multi-tab UI process into a single workflow.

Call POST /people to create the employee, then POST /employees/{employeeId}/invitations with welcome wizard id 42, then POST /employees/{employeeId}/start-date with the agreed date.

Time-Off Coordination

Workforce planning agents read who's-out via GET /timeoff/whosout and GET /timeoff/outtoday, then submit time-off requests with POST /timeoff/employees/{id}/requests when an employee asks via Slack or chat. Balance enquiries through GET /timeoff/employees/{id}/balance let the same agent confirm policy entitlements before submitting.

Call GET /timeoff/employees/1234/balance to confirm vacation balance, then POST /timeoff/employees/1234/requests for the requested dates.

Reporting Pipeline

Analytics teams trigger HR reports via GET /company/reports to discover available reports, then GET /company/reports/{reportId}/download or its async variant to fetch the file. The async download polling pattern handles large reports without blocking the request, ideal for warehouse loaders that ship daily or weekly headcount data.

Call GET /company/reports/{reportId}/download-async, poll the returned URL until the file is ready, then push the contents to a data warehouse loader.

AI Agent HR Operations

Through Jentic, an AI assistant can answer 'how many people are out today?' or 'what's John's start date?' by calling Bob's read endpoints, and submit time-off requests for an employee on demand. Jentic's vault holds the API token, so the agent operates on HR data without seeing the raw credential — important for SOC-2 controls.

Search Jentic for 'who is out of the office today', execute GET /timeoff/outtoday, and return the list as a Slack-friendly summary.

Key Endpoints

94 endpoints — the bob api is hibob's hr platform interface for managing employees, onboarding, time-off, attendance, reports, and company configuration.

METHOD

PATH

DESCRIPTION

POST

/people/search

Search employees with rich filters

POST

/people

Create an employee

POST

/employees/{employeeId}/invitations

Send a welcome wizard invitation

POST

/employees/{identifier}/terminate

Terminate an employee

POST

/timeoff/employees/{id}/requests

Submit a time-off request

GET

/timeoff/whosout

List employees out of the office on a given date

GET

/company/reports/{reportId}/download-async

Async download URL for a large HR report

POST

/people/search

Search employees with rich filters

POST

/people

Create an employee

POST

/employees/{employeeId}/invitations

Send a welcome wizard invitation

POST

/employees/{identifier}/terminate

Terminate an employee

POST

/timeoff/employees/{id}/requests

Submit a time-off request

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

HiBob service-user tokens and Basic credentials are stored encrypted in the Jentic vault. Agents call Bob via Jentic and the right Authorization header is injected per endpoint, so the raw credential never enters the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'create an employee' or 'who is out today') and Jentic returns the matching Bob operation with its input schema, so the agent calls the right endpoint without scanning HiBob's docs.

Time to first call

Direct HiBob integration: 3-5 days for service-user setup, async report polling, custom fields, and time-off flows. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

BambooHR API

BambooHR offers comparable HRIS functionality including employee records, time-off, and reports

Choose BambooHR for SMB HR teams already on its payroll modules; choose HiBob for tech-forward companies that want a richer culture and onboarding stack

Alternative

Rippling API

Rippling unifies HR, IT, and finance with broader app provisioning and device management

Choose Rippling when you need IT provisioning and HR in one platform; choose HiBob for a stronger people-experience focus

Complementary

Gusto API

Gusto handles US payroll and benefits and pairs well with HiBob's employee record system

Use alongside HiBob when you need US-payroll integration and want HiBob to remain the system of record for people data

FAQs

Specific to using Bob API API through Jentic.

What authentication does the Bob API use?

The Bob API supports two schemes: a service-user token passed as Authorization: Bearer <token> (the Bearer scheme in the spec is implemented as an apiKey-style header), or HTTP Basic for service users. Tokens are generated under HiBob's automation users. Through Jentic, both credential types live in the encrypted vault and are injected at execution time.

Can I create and onboard a new employee with the Bob API?

Yes. POST /people creates the employee record; POST /employees/{employeeId}/start-date sets or updates the start date; POST /employees/{employeeId}/invitations sends a welcome wizard. The three calls together handle the onboarding flow that is otherwise multiple screens in the Bob UI.

How do I download a HiBob report through Jentic?

Run pip install jentic, search for 'download a hibob report', and choose between GET /company/reports/{reportId}/download for synchronous downloads or GET /company/reports/{reportId}/download-async for large files. Jentic resolves the auth header from the vault.

Is there a sandbox environment for the Bob API?

Yes — the spec lists https://api.sandbox.hibob.com/v1 as an alternate server. Use it for development and integration testing before pointing your integration at https://api.hibob.com/v1 in production.

How do I list employees who are out today?

Call GET /timeoff/outtoday for the current day or GET /timeoff/whosout with a date parameter for a specific date. Both return the list of employees on time off so an agent can build an out-of-office digest without reading individual time-off records.

What are the rate limits for the Bob API?

HiBob enforces per-token rate limits that are not published in the spec but are returned through HTTP 429 responses. Implement backoff on 429 responses and prefer the async report download endpoints for any payload over a few megabytes to avoid tying up request slots.