Overview

This guide will walk you through how to create a Connected App in Bullhorn Recruitment Cloud and enter your OAuth credentials in Merge.

Instructions

Step 1: Create a Connected App in Bullhorn Recruitment Cloud

1. Log into Salesforce. Click the Gear Icon, and then click "Setup" from the drop down menu.

   

2. Using the Quick Find Search box, search Apps, and select External Client App Manager.

   

3. Click New Connected App

   

   1. Enter a name for the App. Please note that it must be a unique name within your Organization.

   2. Enter an API Name, Contact Email, and select a Distribution State

      

   3. In the API (Enable OAuth Settings) area of the page, check Enable OAuth Settings.

   4. In the App Settings, set the Callback URL to “https://app.merge.dev/oauth/callback”

   5. Add the three scopes below to the Select OAuth Scopes box

      • Access unique user identifiers (openid)

      • Manage user data via APIs (api)

      • Perform requests at any time (refresh_token, offline_access)

   6. Check the Require Secret for Web Server Flow box

   7. Check the Require Secret Refresh Token Flow box

      

4. Click Create to finalize completing your app setup.

Step 2: Set OAuth Policies

1. On the External Client App Manager screen, find the App that you created and click it to open its record

2. Under the Policies tab, click Edit, then open the OAuth Policies dropdown.

   

3. Make sure the Refresh Token Policy is set to: Refresh token is valid until revoked.

4. Make sure the IP Relaxation is set to: Enforce IP restrictions, but relax for refresh tokens.

Don't leave this page yet!

Step 3: Find and enter your Partnership credentials in Merge Dashboard

1. On the External Client App Manager screen for your app, click the Settings tab

2. Click open OAuth Settings

3. Click the Consumer Key and Secret link

   

4. Fetch your Client ID and Secret on the next page and save them for the next step

5. Copy the following values and enter them in the Merge Dashboard

• OAuth Client ID

• OAuth Client Secret

• Callback: https://app.merge.dev/oauth/callback

You're all set!