> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bullhorn

> Follow these steps to connect Bullhorn with StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges for your Bullhorn account.
</Warning>

If you've been directed to StackOne to integrate with Bullhorn, the following steps will help you understand the process and any necessary actions to configure a successful integration.

## Getting your Client ID, Client Secret and API Username

These are unique identifiers for your account. If you do not possess this information, please contact Bullhorn Support or Submit a ticket via the [Bullhorn Resource Center](https://www.bullhorn.com/au/technical-support-2/)

You will need to contact Bullhorn support to "add the following redirect URI: `https://api.stackone.com/connect/oauth2/bullhorn_ats/callback`".

## Identify a Bullhorn Custom Field for Data Storage

This connection will store Background Check and Assessment information within a custom field in Bullhorn. To avoid overwriting existing data, please identify an unused custom field in your Bullhorn instance.

You will be able to select `customTextBlock` 1 through 10 for this "Custom Field" in the connection step below.

*Example*: `customTextBlock4`

## (optional) Getting a Client Corporation ID and Client Contact ID

To create a new Job with this connection, a **Client Corporation ID** (Company ID) and **Client Contact ID** are required to be associated with the new Job.

The **Client Corporation ID** can be seen in the main *Companies* page in your Bullhorn instance:

<img src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bullhorn-company-ids.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=0d550f28494bd98e4cd38d9ee3e3b3b5" alt="Bullhorn Company Ids Pn" width="837" height="451" data-path="images/bullhorn-company-ids.png" />

The **Client Contact ID** can be seen by viewing the *Contacts* of the same Company you will be using for this step.

<img src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bullhorn/company-contacts-ids.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=9994053e80cd7790c35c7dc8911c8a57" alt="Company Contacts Ids Pn" width="754" height="375" data-path="images/bullhorn/company-contacts-ids.png" />

## Connecting to StackOne

<Steps>
  <Step title="Enter your API credentials">
    Upon reaching the Link Account page, enter the following credentials received from Bullhorn Support:

    * Client ID
    * Client Secret
    * API Username
  </Step>

  <Step title="Enter additional connection information">
    * Custom Field
      * Used for Background Check and Assessment data storage
    * Client Corporation ID (optional)
      * Required for creating Jobs
    * Client Contact ID  (optional)
      * Required for creating Jobs

    After entering the information above, proceed by clicking the `Connect` button.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Enter your API credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bullhorn/image1.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=c815888eb57f15e58885d92d268d7cf0" width="486" height="759" data-path="images/bullhorn/image1.png" />
    </Frame>
  </Step>

  <Step title="Log in to your Bullhorn account">
    In the window that appears, log in to your Bullhorn account to authorize account access.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Log in to your Bullhorn account" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bullhorn/image2.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=8b2f0f9afdd1d6c884faca23c41d26ee" width="594" height="507" data-path="images/bullhorn/image2.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Useful Links

<Card title="API Reference" icon="link" href="https://bullhorn.github.io/Getting-Started-with-REST">
  [https://bullhorn.github.io/Getting-Started-with-REST](https://bullhorn.github.io/Getting-Started-with-REST)
</Card>