<aside> 🚇 On this page: Step-by-step guide for connecting your Bob and Orgnostic accounts.

Related pages:


Before you start

<aside> ⚠️ Note: you need access to a Bob account with admin privileges to complete this task.


<aside> 🚧 Caveat: third-party services and platforms may change the layout of their user interface and render this guide obsolete. We do our best to keep it up to date, but if you notice any discrepancies, please write to [email protected] and we will fix the issue ASAP.


Create a service type user for taking API actions, without affecting headcount or the people directory.

What is an API service user?

An API service user is a user type in Bob whose sole purpose is to manage APIs in Bob. Multiple service users can be created with unique permissions for each.

A service user stays active regardless of the status of the person who created the service user, unlike user tokens.

Note: Service users are dedicated API users that are used to pull data from Bob and share with Orgnostic. The service users are detached from any actual employee and have custom permissions that are defined by the admin. These users cannot "log in" to Bob and are used only by the HiBob public API.

Fetch API key from Bob

  1. Log into your Bob account

  2. Make sure you have Admin privileges

  3. From the left hand menu, select Settings > Integrations

  4. Select Automation

  5. Click the Service Users thumbnail

    Screenshot 2023-05-22 at 19.23.21.png

  6. Enter a unique name (orgnostic_int) and a display name “Orgnostic Integration”


  1. Click Save.
  2. The new service user’s ID and token are now displayed — do not close the dialog and make sure to keep the token in a safe place, you will not be able to access it again!