Hibob (OAuth) – Connection Guide

Service ID: hibob-oauth

bob is a people management platform that helps fast-growing companies bring out the best in their employees. OAuth 2.0 authorization-code flow for multi-tenant connections.

How to connect HiBob

Connecting HiBob takes one click — log in to Bob, review the access being requested, and approve. There is nothing to copy, paste, or generate beforehand.

Prerequisites

You must be a Bob admin (or have permission to install marketplace apps) on the HiBob tenant you want to connect. If you are not, ask your HiBob administrator to do the connection step for you.

Connect via Vault

  1. In the connection screen, find HiBob in the list of connectors and click Connect.

  2. You will be redirected to HiBob. If you are not already signed in, Bob will prompt you to log in to your HiBob tenant.

  3. Bob shows the app install screen listing the data the application is requesting access to (for example: read employee data, read departments, read time-off). Review the scopes and click Authorize to grant access.

  4. Bob redirects you back, and the connection is now active with a success state.

That's it — your HiBob account is connected 🎉.

The access token refreshes automatically — you will not be asked to reconnect under normal use.

Revoking access

To fully revoke access you must complete both of these steps — doing only one leaves the connection in a broken or misleading state (see Troubleshooting below):

  1. Disconnect from this app: open the connection screen and click Disconnect.
  2. Uninstall from inside Bob: go to Settings → Integrations → Marketplace apps, find the app, and click Uninstall.

Important: Always do both steps. HiBob does not expose any way to check whether the app is still installed, so Apideck cannot detect or reconcile a half-revoked state on your behalf. Skipping either step can cause 401 errors on every call or a connection that falsely shows as connected in Vault.

Once both steps are complete, the integration can no longer call your HiBob tenant. You can reconnect at any time by repeating the steps above.

Troubleshooting

"You don't have permission to install apps"

Your HiBob user does not have the install marketplace apps permission. Ask a Bob admin in your tenant to either grant you that permission or complete the connection step for you.

"App not found" or a blank install screen

The application owner's HiBob app configuration is missing or wrong. Contact the team that gave you access to this integration — they will need to check the HiBob developer portal on their side.

"Invalid redirect URI"

Same as above — this is a configuration issue on the application owner's side, not something you can fix. Let them know what URL you saw in the address bar when the error appeared.

Errors or a misleading state after disconnecting / uninstalling

These happen when only one of the two revoke steps was completed (see Revoking access). Because HiBob provides no endpoint to check whether the app is still installed, Apideck cannot detect or fix these states automatically — the only reliable fix is to always complete both steps.