Overview
Caspian is an IT platform. It connects to a company’s identity provider, SaaS apps and laptops, and runs the IT side of joining, moving and leaving. The HiBob integration makes Bob the source for those events: when HR adds a hire in Bob, Caspian can set up their accounts, laptop and app access before their first day, and when HR enters a last day, Caspian can remove their access in the other apps on time. The integration only reads from Bob. Caspian never changes anything in Bob.Before you start
- A Bob account with the rights to install apps from the Bob Marketplace (usually a Bob admin).
- A Caspian workspace at app.getcaspian.io and a Caspian admin login. A new workspace first connects its identity provider (Microsoft Entra ID, Google Workspace or Okta); that is the directory where Caspian creates and removes accounts. See Connect your identity provider.
- About five minutes.
Install the app
You can start from either side. Both end on the same Bob consent screen, where you sign in to Bob; Caspian never asks for a Bob password or API token.From the Bob Marketplace
Find Caspian in Bob

Land on Caspian's HiBob page

Approve access in Bob

Back in Caspian
From Caspian
Open HiBob in Caspian

Connect
Approve access in Bob

HiBob connected in Caspian: what it reads and when it last synced
What Caspian reads, and how often
Caspian asks Bob for three read-only scopes:employee_data:read, employee_data.history:read and company.metadata:read. With them it reads, for each employee:
Set up workflows in Caspian
Connecting HiBob does not change anything on its own. You decide what happens when someone joins, moves or leaves, in Caspian’s Lifecycle workflows.- In Caspian, open Lifecycle and open the onboarding workflow (or the offboarding one for leavers).
- Under Trigger, choose HiBob:
- New hire: starts as soon as the hire is added in Bob, or a number of days before their start date.
- Employee leaves: starts as soon as the termination is in Bob, or a number of days before or after their last day.
- Department changes: starts when someone moves to another department, or to one department you name.
- Add the steps, for example: create the person’s account in the identity provider, order their laptop and add them to the right groups; the Access rules give them their apps. For a leaver: transfer their files, collect the laptop and suspend or remove their accounts.
- Click Publish. Each hire, leaver or move then starts its own run, which you follow under Lifecycle › Runs.

An onboarding workflow that starts on a HiBob start date

An offboarding workflow that starts when an employee leaves in HiBob
How the data flows
Data goes one way: from Bob to Caspian. Caspian then acts in the identity provider and the other apps, never in Bob.Joiner
- HR adds the hire in Bob with a start date.
- On its next read (every 6 hours, or Check now), Caspian sees the new person, before their first day.
- The person appears under Lifecycle › Runs as an upcoming joiner, and every workflow with the New hire trigger starts a run for them at the moment you chose.
- The run creates their accounts, adds their app access and creates the laptop task, so everything is ready on day one.

Upcoming joiners from HiBob under Lifecycle › Runs, each queued for their start date
Mover
- HR changes the person’s department in Bob.
- On its next read, Caspian sees the change and keeps the previous department.
- Every workflow with the Department changes trigger starts a run, for example to move the person into the new team’s groups and apps.
Leaver
- HR enters the termination and the last day in Bob.
- On its next read, Caspian sees the termination date, also when the last day is still weeks away.
- Every workflow with the Employee leaves trigger starts a run at the moment you chose: before, on or after the last day.
- The run removes the person’s access in the other apps. Caspian asks a person to approve each removal before it makes it, and logs it.
Uninstall
- In Bob, open the Bob Marketplace, then Manage apps.
- Under Installed apps, find Caspian and click Uninstall.
Troubleshooting
Hires who have not started yet, or people who left, are missing
Hires who have not started yet, or people who left, are missing
A hire who was just added does not show
A hire who was just added does not show
A leaver's run did not start
A leaver's run did not start
A department change did not start a run
A department change did not start a run
HiBob shows as disconnected
HiBob shows as disconnected
Someone shows twice, or is not matched to their accounts
Someone shows twice, or is not matched to their accounts