---
title: "How to Register a HiBob Developer App and Get OAUTH2 Credentials"
img: https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_a_hibob_developer_app_and_get_oauth2_credentials-icon.png
date: 2026-11-16T00:00:00.000Z
updated: "2026-11-16T22:30:51.206Z"
tag: Guides
integrations: hibob
description: "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..."
url: "https://docs.unified.to/guides/how_to_register_a_hibob_developer_app_and_get_oauth2_credentials"
---

# 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](https://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](https://www.hibob.com/partner/) 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

1. Submit the [Tech Partner Application](https://www.hibob.com/partner/) form.
2. Once the HiBob Tech Partnerships team approves your application, sign HiBob's partner Terms and Conditions.
3. 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](https://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

1. Log in to the [HiBob Developer Portal](https://developers.hibob.com/).
2. In the top left, select **My apps**, then click **Create app**.
3. 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).
4. 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

1. In your app, click **OAuth** and scroll to **redirect URI**.
2. If you are going to use [Unified.to](https://unified.to/) with these credentials, enter Unified's OAuth redirect URI:

```plain text
https://api.unified.to/oauth/code
```

- EU workspaces use `https://api-eu.unified.to/oauth/code` and AU workspaces use `https://api-au.unified.to/oauth/code`.
1. 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:  
> ```plain text  
> 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 example `Production`.  
>   
> - EU workspaces use `https://api-eu.unified.to/...` and AU workspaces use `https://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.

1. Click **Manage scopes**.
2. Expand the topics on the left and select the actions your product needs. Request only what you use. Some HiBob endpoints only offer a `:write` scope, which also covers reading. See HiBob's [scopes mapping](https://apidocs.hibob.com/reference/scopes-mapping-to-endpoints).
3. 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](mailto: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](https://apidocs.hibob.com/docs/add-and-submit-an-app) guide for the full checklist.


## Step 7: Activate HiBob in [Unified.to](https://unified.to/)

1. Navigate to [Active Integrations](https://app.unified.to/integrations).
2. Search for HiBob and click on it.
3. Choose **OAuth 2** as the authorization method.
4. Enter the **Client ID**, **Client Secret** and **App ID** from Step 5.
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.


## More information

- [How to connect HiBob (Bob) to Unified with OAuth 2.0](https://app.notion.com/p/4106207b8384817096a5e52b93c0d438)
- [HiBob: OAuth 2.0 reference](https://apidocs.hibob.com/reference/oauth-20)
- [HiBob: Add and submit an app](https://apidocs.hibob.com/docs/add-and-submit-an-app)