How to Register a HiBob Developer App and Get OAUTH2 Credentials
November 16, 2026
Developers who want to build HRIS integrations between their SaaS product and HiBob (Bob) with OAuth 2.0 need to register an app in the HiBob Developer Portal and get its OAuth 2.0 credentials. In this article, we'll walk through how to get those credentials and add them to Unified.to.
⚠️ You must be an official HiBob partner to use OAuth 2.0. HiBob only offers OAuth 2.0 app integrations to approved HiBob Marketplace and technology partners. If your company isn't a HiBob partner yet, apply through the HiBob Tech Partner program first. Customers building their own integration (not partners) should connect with a HiBob Service User ID and token instead.
Step 1: Become an approved HiBob partner
- Submit the Tech Partner Application form.
- Once the HiBob Tech Partnerships team approves your application, sign HiBob's partner Terms and Conditions.
- HiBob then gives you a Bob Partner account (a Bob account you can use for testing) and an invitation to the HiBob Developer Portal (developers.hibob.com).
You can't create an OAuth app until you have Developer Portal access.
Step 2: Create an app in the HiBob Developer Portal
- Log in to the HiBob Developer Portal.
- In the top left, select My apps, then click Create app.
- Fill in the Basic Information: App icon (160 x 160 px), App name, App description and Built by (your company name, if it's different from the app name).
- Under Installing your app, choose how customers install it: Install from Bob Marketplace or Install from your landing page (this one also needs your HTTPS Landing page URL). Click Save.
Step 3: Set the Redirect URI
- In your app, click OAuth and scroll to redirect URI.
- If you are going to use Unified.to with these credentials, enter Unified's OAuth redirect URI:
https://api.unified.to/oauth/code
- EU workspaces use
https://api-eu.unified.to/oauth/codeand AU workspaces usehttps://api-au.unified.to/oauth/code.
- Click Save.
💡 Customers install your app from the Bob Marketplace? When an install starts in the Bob Marketplace, HiBob sends customers back without the information Unified uses to match the install to your workspace. Use this redirect URI instead:
https://api.unified.to/hb/{YOUR_WORKSPACE_ID}/{ENVIRONMENT}/connection
- Replace
{YOUR_WORKSPACE_ID}with your Unified workspace ID (in the Unified app under Settings) and{ENVIRONMENT}with your Unified environment, for exampleProduction.- EU workspaces use
https://api-eu.unified.to/...and AU workspaces usehttps://api-au.unified.to/....- HiBob allows one redirect URI per app. With this URI, installs started from your own app through Unified's authorization flow won't work, because those use
/oauth/code. Choose the URI that matches where your customers start the install.
Step 4: Select scopes
HiBob requires at least one scope before you can test the app.
- Click Manage scopes.
- Expand the topics on the left and select the actions your product needs. Request only what you use. Some HiBob endpoints only offer a
:writescope, which also covers reading. See HiBob's scopes mapping. - Click Apply, then Save.
Step 5: Get your App ID, Client ID and Client Secret
On the app's OAuth page:
- Development Credentials shows a Client ID and Client Secret you can use for testing with your Bob Partner account before HiBob approves your app.
- Production credentials shows the Client ID and Client secret to use with real customers. These are used once HiBob approves your app and you agree on a go-live date.
- Copy your app's App ID as well. Unified needs it to start the install. The App ID is not the same as the Client ID.
Copy these values and store them somewhere safe. If your client secret is ever exposed, contact HiBob at partnersupport@hibob.io with your App ID and rotate the secret in the Developer Portal. Rotating it invalidates existing refresh tokens, so every customer has to reinstall your app.
Step 6: Submit your app for review
Before customers can install your app in production, click Submit for review in the Developer Portal. HiBob runs a technical review and a listing review (plus a security review for payroll apps), and asks for a working, tested integration, your Marketplace listing content, a certification video and a public user guide. See HiBob's Add and submit an app guide for the full checklist.
Step 7: Activate HiBob in Unified.to
- Navigate to Active Integrations.
- Search for HiBob and click on it.
- Choose OAuth 2 as the authorization method.
- Enter the Client ID, Client Secret and App ID from Step 5.
- Select the same permissions you chose in Step 4, then click Activate.
While you're testing with Development Credentials, connect with the Development Environment option for HiBob in Unified so the install runs in HiBob's dev mode. Switch to your Production credentials once your app is approved.