> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Bullhorn for Salesforce ATS Integration

> Bullhorn for Salesforce connector for Kombo's ATS API

<Note>This connector is in closed beta. Please contact us to get access.</Note>

The Bullhorn for Salesforce ATS integration allows you to sync ATS data between Bullhorn for Salesforce and your application through Kombo's unified API. The tool slug for this connector is `bullhorn4salesforce`.

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/46620810469649-Bullhorn-for-Salesforce-Setup-Guide">
    Step-by-step instructions to connect your Bullhorn for Salesforce account to Kombo.
  </Card>
</CardGroup>

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Jobs">
      | Field                | Notes |
      | -------------------- | ----- |
      | id                   |       |
      | remote\_id           |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
      | name                 |       |
      | job\_code            |       |
      | description          |       |
      | confidential         |       |
      | employment\_type     |       |
      | status               |       |
      | visibility           |       |
      | category             |       |
      | department           |       |
      | post\_url            |       |
      | experience\_level    |       |
      | salary\_amount\_from |       |
      | salary\_amount\_to   |       |
      | salary\_currency     |       |
      | location             |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | remote\_url          |       |
      | opened\_at           |       |
      | closed\_at           |       |
      | remote\_created\_at  |       |
      | remote\_updated\_at  |       |
      | remote\_data         |       |
    </Accordion>

    <Accordion title="Candidates">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | title               |       |
      | source              |       |
      | phone\_numbers      |       |
      | email\_addresses    |       |
      | social\_media       |       |
      | location            |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_url         |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Application Stages">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | global\_index       |       |
    </Accordion>

    <Accordion title="Applications">
      | Field                   | Notes |
      | ----------------------- | ----- |
      | id                      |       |
      | remote\_id              |       |
      | changed\_at             |       |
      | remote\_deleted\_at     |       |
      | outcome                 |       |
      | rejection\_reason\_name |       |
      | current\_stage\_id      |       |
      | job\_id                 |       |
      | candidate\_id           |       |
      | custom\_fields          |       |
      | integration\_fields     |       |
      | remote\_url             |       |
      | remote\_created\_at     |       |
      | remote\_updated\_at     |       |
      | remote\_data            |       |
    </Accordion>

    <Accordion title="Job-specific application stages">
      | Field               | Notes |
      | ------------------- | ----- |
      | index               |       |
      | job\_id             |       |
      | stage\_id           |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Add attachment to application">
      <Note>
        Attachments are linked to the candidate (Contact) in Salesforce, not directly to the application. This action will fall back to the "Add attachment to candidate" action. Therefore, there could be cases where the attachment may not be added to the application but rather to the candidate.
      </Note>

      | Input Field              | Notes |
      | ------------------------ | ----- |
      | application\_id          |       |
      | attachment.name          |       |
      | attachment.content\_type |       |
      | attachment.data\_url     |       |
      | attachment.data          |       |
    </Accordion>

    <Accordion title="Move application to stage">
      <Note>
        Moving a Job Board Application converts it into a new Application: the Job Board Application is marked as `Converted` in Bullhorn and a fresh Application record is created in its place. Job Board Applications can only be converted once — moving the same Job Board Application twice fails with `APPLICATION_ALREADY_EXISTS`. Application stages are surfaced per job RecordType, but — depending on the org's Salesforce config — not every stage exposed on a job is selectable: `TR1__Stage__c` may be a restricted picklist, in which case moving to a value it doesn't accept fails with `INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST`.
      </Note>

      | Input Field     | Notes |
      | --------------- | ----- |
      | application\_id |       |
      | stage\_id       |       |
    </Accordion>

    <Accordion title="Add result link to application">
      <Note>
        Result links are created as Salesforce Tasks.
      </Note>

      | Input Field                         | Notes |
      | ----------------------------------- | ----- |
      | application\_id                     |       |
      | label                               |       |
      | url                                 |       |
      | details.custom\_field\_name\_prefix |       |
      | details.attributes.key              |       |
      | details.attributes.value            |       |
    </Accordion>

    <Accordion title="Add note to application">
      <Note>
        Notes are created as Salesforce Tasks.
      </Note>

      | Input Field     | Notes |
      | --------------- | ----- |
      | application\_id |       |
      | content         |       |
    </Accordion>

    <Accordion title="Get candidate attachments">
      | Input Field   | Notes |
      | ------------- | ----- |
      | candidate\_id |       |
    </Accordion>

    <Accordion title="Add attachment to candidate">
      <Note>
        Attachments are linked to the candidate (Contact) in Salesforce, not directly to the application.
      </Note>

      | Input Field              | Notes |
      | ------------------------ | ----- |
      | candidate\_id            |       |
      | attachment.name          |       |
      | attachment.content\_type |       |
      | attachment.data\_url     |       |
      | attachment.data          |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature               | Notes                                                                                                                                                                                                                                                           |
    | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Connection Guide      |                                                                                                                                                                                                                                                                 |
    | API Passthrough       |                                                                                                                                                                                                                                                                 |
    | Scope Testing         |                                                                                                                                                                                                                                                                 |
    | Per Model Tests       |                                                                                                                                                                                                                                                                 |
    | Per Field Tests       | Read-side: asserts every field in BH4SF\_SYNC\_QUERY\_FIELDS.contact/.application/.job is present in the describe response. Write-side: asserts updateable on each field written by a known action (currently: TR1\_\_Stage\_\_c for kpAtsSetApplicationStage). |
    | Delta Syncs           |                                                                                                                                                                                                                                                                 |
    | Custom Field Explorer |                                                                                                                                                                                                                                                                 |
    | Jobs                  |                                                                                                                                                                                                                                                                 |
    | Candidates            |                                                                                                                                                                                                                                                                 |
    | Applications          |                                                                                                                                                                                                                                                                 |
  </Tab>
</Tabs>
