How to connect to HiBob

Connecting HiBob takes one click. You log in to Bob, review the access being requested, and approve. HiBob then installs the integration's Marketplace app into your Bob tenant. There is nothing to copy, paste, or generate beforehand, and no credentials for you to enter.

Read this before you connect: disconnecting later takes two steps, one in this app and one inside Bob. HiBob provides no way to check whether the app is still installed, so a half-finished disconnect cannot be detected or repaired for you. See Revoking access.

Prerequisites

• A HiBob (Bob) account on the tenant you want to connect.
• Bob admin rights, or the permission to install Marketplace apps. If you do not have either, ask your HiBob administrator to complete the connection step for you.

Connect

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

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

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

4. Bob redirects you back, and the connection shows as connected.

That is it: your HiBob account is connected.

Staying connected

Access is refreshed automatically, so under normal use you are never asked to reconnect. The one exception is a long period of inactivity: HiBob's refresh window is 30 days, so a connection that goes unused beyond it stops working and has to be connected again by repeating the steps above. Nothing is lost by reconnecting.

Revoking access

Revoking takes both of the steps below. Completing only one leaves the connection in a broken or misleading state, and that state cannot be detected for you (see Troubleshooting).

1. Disconnect here: open the connection screen and click Disconnect.
2. Uninstall inside Bob: go to Settings > Integrations > Marketplace apps, find the app, and click Uninstall. HiBob documents this screen in Integrations tab in the Bob Help Center.

Always do both. HiBob exposes no way to read whether the app is still installed, so a half-revoked connection cannot be reconciled on your behalf:

• Uninstalling in Bob but not disconnecting here leaves a connection that still shows as connected while every call fails with a 401 error.
• Disconnecting here but not uninstalling in Bob leaves the app installed in your tenant, listed under Marketplace apps, even though nothing is using it.

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

Troubleshooting

"You don't have permission to install apps"

Your Bob user does not have the permission to install Marketplace apps. 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 app's HiBob configuration is missing or incorrect. This is set up by the team that provides the integration, not by you: contact them so they can check it on their side.

"Invalid redirect URI"

Same cause as above: a configuration issue on the integration provider's side, not something you can fix. Let them know which URL was in your browser's address bar when the error appeared.

401 errors, or a connection that looks connected but is not

This is the signature of a half-finished revoke, where only one of the two steps in Revoking access was completed. Complete the missing step, then connect again from scratch if you still need the integration.

Anything else

Contact Apideck Support.