Skip to main content
All CollectionsPeople Analytics (formerly Orgnostic)🤝 Connect external data sourcesHRIS
Bob (People Analytics)
Bob (People Analytics)
Jessie Walsh avatar
Written by Jessie Walsh
Updated over a week ago

🚇 On this page:

Step-by-step guide for connecting your Bob and People Analytics accounts.

Related pages:

Before you start

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

🚧 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, just reply with "Ask a Person" in a Support Conversation to speak with a Product Support Specialist 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 People Analytics. 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

6. Enter a unique name (peopleanalytics_int) and a display name “People Analytics Integration”

7. Click Save.

8. 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!

Creating a permission group and assigning permissions to People Analytics service user

By default, service users are created with no access permissions.

You therefore need to create a specific permissions group for service users and add the service user to that group to ensure People Analytics has access to the relevant data. To learn more, see Create a custom permissions group. Here is how you can do it:

  1. Create an People Analytics permissions group ⬇️

    1. In Bob, select Settings > Permission groups from the left menu

    2. Click on Create group

    3. Give the Permission Group a name (People Analytics)

  2. Add the service user you created in the previous step to the permission group ⬇️

    1. Click on Select people by condition, then select Edit

    2. Delete the Lifecycle status condition that is shown by default

    3. Click on Add specific employees and select People Analytics service user from the list of service users

    4. Click Apply

  3. Set the needed permissions in the People’s Data tab ⬇️

    • Ensure the Access rights are set to Lifecycle status equals Any

    • Assign the permissions to the People Analytics service user in the People tab

🗝 List of required permissions

About:

  • ✔ View selected employees’ About sections

Basic info:

  • ✔️ View selected employees’ Basic info section histories

  • ✔️ View selected employees’ Basic info sections

Date of Birth:

  • ✔️ View selected employees’ Date of Birth section histories

  • ✔️ Edit selected employees’ Date of Birth sections

(we don't edit anything, but Bob do require us to have this permission)

Jobs:

  • ✔️ View selected employees’ Jobs section histories

  • ✔️ View selected employees’ Jobs sections

Lifecycle:

  • ✔ View selected employees’ Lifecycle section histories

  • ✔️ View selected employees’ Lifecycle sections

Payroll:

  • ✔ View selected employees’ Payroll section histories

  • ✔️ View selected employees’ Payroll sections

Personal:

  • ✔️ View selected employees’ Personal section histories

  • ✔️ Edit selected employees’ Personal sections

(we don't edit anything, but Bob do require us to have this permission)

User data:

  • ✔ View selected employees’ User data section histories

  • ✔️ View selected employees’ User data sections

Work:

  • ✔️ View selected employees’ Work section histories

  • ✔️ View selected employees’ Work sections

Work contact details:

  • ✔️ View selected employees’ Work contact details sections

Employment:

  • ✔ View selected employees’ Employment section histories

  • ✔️ View selected employees’ Employment sections

Equity:

  • ✔️ View selected employees’ Equity section histories

  • ✔️ View selected employees’ Equity sections

If you have previously created a permissions group for People Analytics service user, you'll need to add the user to this group.

From the left menu, select Settings > Permissions groups > choose the relevant group > Group actions > Edit details > Select people by condition > Edit > Add specific employees > People Analytics service user > Apply.

Understanding User Permissions

The standard set of required permissions is defined below, however, the categories may have been renamed in your Bob system, so the descriptions may not match exactly. Please check your Bob set-up to ensure the correct categories are assigned. Additional categories may be required if you have chosen to sync custom fields from different categories.

If you have any doubts, you can assign the service user View permissions to all categories, except for the Personal section (we don't edit anything, but Bob do require us to have this permission).

Enable Bob HR Integration

  1. In People Analytics, on the top right corner click on your name, then go to My Profile

2. At the bottom of the My Profile page you'll see the Connected Apps section. Choose Bob and click Connect

3. Paste your Bob API key into the first field of the connection form.

4. Click Connect Bob.

Your People Analytics profile is now connected with Bob.

People Analytics will start fetching the data right away. The process will take a while to complete. Its duration varies depending on the number of things you track and their health.

Once it’s done, you will be all set to start exploring your people metrics. 🥳

Metrics imported from Bob

The following metrics will show up in your People Analytics Stories and Chapters after you connect Bob.

Diversity

Headcount

Leadership

Rewards

Talent Acquisition

Leadership

Turnover

💬 Need help? Just reply with "Ask a Person" in a Support Conversation to speak with a Product Support Specialist.

Did this answer your question?