Viio

Connect your HiBob HRIS to Viio to bring in a clean, always-up-to-date employee roster—perfect for mapping licences and spotting shadow IT gaps.

___________________________________________________________

You must be a HiBob admin (or have permission to create Service users). <a href="https://apidocs.hibob.com/docs/api-service-users" rel="nofollow noopener noreferrer" target="_blank">apidocs.hibob.com</a>

Create a Service user and place it in a permission group that grants at least the Default Employee Fields (root, about, employment, work). <a href="https://apidocs.hibob.com/docs/api-service-users" rel="nofollow noopener noreferrer" target="_blank">apidocs.hibob.com</a>

Make sure you can copy the Service user ID and Token—you’ll paste both in Viio.

- You must be a HiBob admin (or have permission to create Service users). <a href="https://apidocs.hibob.com/docs/api-service-users" rel="nofollow noopener noreferrer" target="_blank">apidocs.hibob.com</a>
- Create a Service user and place it in a permission group that grants at least the Default Employee Fields (root, about, employment, work). <a href="https://apidocs.hibob.com/docs/api-service-users" rel="nofollow noopener noreferrer" target="_blank">apidocs.hibob.com</a>
- Make sure you can copy the Service user ID and Token—you’ll paste both in Viio.

Go to Viio → Integrations and choose HiBob.

In HiBob, generate a Service user:

1. Navigate to Settings → Integrations → Service users.
2. Click Create service user, then copy the User ID and Token.
3. Add the user to, or create, a permission group with view access to the Default Employee Fields. <a href="https://apidocs.hibob.com/docs/api-service-users" rel="nofollow noopener noreferrer" target="_blank">apidocs.hibob.com</a>

Back in Viio, press Connect HiBob, paste the User ID and Token, then click Save.

Viio kicks off the first sync—it usually finishes within 15 minutes. You’ll see the status turn to Healthy when done.

1. Go to Viio → Integrations and choose HiBob.
2. In HiBob, generate a Service user:
 1. Navigate to Settings → Integrations → Service users.
 2. Click Create service user, then copy the User ID and Token.
 3. Add the user to, or create, a permission group with view access to the Default Employee Fields. <a href="https://apidocs.hibob.com/docs/api-service-users" rel="nofollow noopener noreferrer" target="_blank">apidocs.hibob.com</a>
3. Back in Viio, press Connect HiBob, paste the User ID and Token, then click Save.
4. Viio kicks off the first sync—it usually finishes within 15 minutes. You’ll see the status turn to Healthy when done.

Need to disconnect? Open Installed apps → HiBob → Remove in Viio, then delete or revoke the Service user in HiBob if you no longer need the token.

Authentication – Service user ID and Token sent via HTTP <code>Authorization</code> header.

- <code>POST /people/search</code> – pull employee directory <a href="https://apidocs.hibob.com/reference/post_people-search" rel="nofollow noopener noreferrer" target="_blank">apidocs.hibob.com</a>
- <code>GET /people/{id}</code> – fetch extended profile &amp; org metadata

Data cadence – Viio refreshes HiBob data daily

In order for Viio to be able to fetch usage, audit reports need to be enabled - read more on how <a href="https://help.hibob.com/en/articles/3651065-audit-report" rel="nofollow noopener noreferrer" target="_blank">here</a>

- Authentication – Service user ID and Token sent via HTTP <code>Authorization</code> header.
- Primary endpoints called
 - <code>POST /people/search</code> – pull employee directory <a href="https://apidocs.hibob.com/reference/post_people-search" rel="nofollow noopener noreferrer" target="_blank">apidocs.hibob.com</a>
 - <code>GET /people/{id}</code> – fetch extended profile &amp; org metadata
- Data cadence – Viio refreshes HiBob data daily
- In order for Viio to be able to fetch usage, audit reports need to be enabled - read more on how <a href="https://help.hibob.com/en/articles/3651065-audit-report" rel="nofollow noopener noreferrer" target="_blank">here</a>

HiBob Public API docs: <a href="" rel="nofollow noopener noreferrer" target="_blank">https://apidocs.hibob.com</a>

- HiBob Public API docs: <a href="" rel="nofollow noopener noreferrer" target="_blank">https://apidocs.hibob.com</a>

Setup Hibob integration effortlessly and get valuable insights

HiBob Integration

→ Email support

→ Contact us

→ Visit website

Still need help?

support@viio.io

Find answers and get help from Intercom Support and Community Experts

This site employs cookies and other technologies that we and our third party vendors use to monitor and record personal information about you and your interactions with the site (including content viewed, cursor movements, screen recordings, and chat contents) for the purposes described in our Cookie Policy. By continuing to visit our site, you agree to our {websiteTermsLink}, {privacyPolicyLink} and {cookiePolicyLink}.

This site uses cookies and similar technologies ("cookies") as strictly necessary for site operation. We and our partners also would like to set additional cookies to enable site performance analytics, functionality, advertising and social media features. See our {cookiePolicyLink} for details. You can change your cookie preferences in our Cookie Settings.

We use cookies to make our site work and also for analytics and advertising purposes. You can enable or disable optional cookies as desired. See our {cookiePolicyLink} for more details.

Advertising cookies are set by our advertising partners to collect information about your use of the site, our communications, and other online services over time and with different browsers and devices. They use this information to show you ads online that they think will interest you and measure the ads' performance. Social media cookies are set by social media platforms to enable you to share content on those platforms, and are capable of tracking information about your activity across other online services for use as described in their privacy policies.

These cookies enable the website to provide enhanced functionality and personalisation. They may be set by us or by third party providers whose services we have added to our pages. If you do not allow these cookies then some or all of these services may not function properly.

These cookies are necessary for the website to function and cannot be switched off in our systems.

These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. They help us to know which pages are the most and least popular and see how visitors move around the site.

You have the right to opt out of the sale of your personal information. See our {cookiePolicyLink} for more details about how we use your data.

Your Privacy Choices

We use cookies to enhance your experience. You can customize your cookie preferences below. See our {cookiePolicyLink} for more details.

Cookie Settings

Link, Press control-option-right-arrow to exit

Empty Help Center

Uh oh. That page doesn’t exist.

Disappointed

Neutral

Smiley

Thinking...

Searching through sources...

Analyzing...

Tickets submitted through the messenger or by a support agent in your conversation will appear here.

Capability	What Viio pulls from HiBob
✅ Users	Full name, corporate email, job title, employment status, start & termination dates
✅ Usage	Department, location, manager hierarchy, cost-centre

Symptom	Quick fix
“Invalid credentials” when connecting	The Service user’s token was regenerated or revoked. Copy the new token and update the integration.
403 “Forbidden” after sync starts	The permission group is missing the Default Employee Fields. Add view access and re-run the sync.
Former employees missing	Edit the permission group’s Access data for rule; remove the filter that limits data to Lifecycle status = Employed. apidocs.hibob.com

HiBob Integration

Capabilities

Prerequisites

Setup

Troubleshooting & FAQ

Technical details

Additional resources