> ## 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.

# SAP SuccessFactors ATS Integration

> SAP SuccessFactors connector for Kombo's ATS API

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

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/16225034050961-How-do-I-link-my-SAP-SuccessFactors-account-">
    Step-by-step instructions to connect your SAP SuccessFactors account to Kombo.
  </Card>

  <Card title="Source Setup Guide" icon="settings" href="https://help.kombo.dev/hc/en-us/articles/19963566832145">
    Learn how to set up candidate sources in SAP SuccessFactors.
  </Card>

  <Card title="View Candidate Sources" icon="eye" href="https://help.kombo.dev/hc/en-us/articles/22582061339409-Successfactors-How-to-view-a-candidates-source">
    How to view and manage candidate sources in SAP SuccessFactors.
  </Card>
</CardGroup>

## General Notes

* For detailed **job location** data, you need the *"Employee Central API: Employee Central Foundation OData API"* permission, which provides access to general data such as locations and legal entities.

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Users">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | email               |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Jobs">
      <Note>
        Access to specific job locations requires the additional permission, "Employee Central API: Employee Central Foundation OData API" to be granted. The post\_url is generated by Kombo and will redirect the candidate to the relevant job posting application page. In some cases, the candidate will instead be redirected by SuccessFactors to a log in page, as some career sites require account creation first.
      </Note>

      | Field                | Notes |
      | -------------------- | ----- |
      | id                   |       |
      | remote\_id           |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
      | name                 |       |
      | job\_code            |       |
      | description          |       |
      | weekly\_hours        |       |
      | status               |       |
      | visibility           |       |
      | post\_url            |       |
      | salary\_amount       |       |
      | salary\_amount\_from |       |
      | salary\_amount\_to   |       |
      | salary\_currency     |       |
      | salary\_period       |       |
      | location             |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | opened\_at           |       |
      | closed\_at           |       |
      | remote\_created\_at  |       |
      | remote\_updated\_at  |       |
      | remote\_data         |       |
    </Accordion>

    <Accordion title="Job postings">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | title               |       |
      | description\_html   |       |
      | status              |       |
      | visibility          |       |
      | job\_id             |       |
      | remote\_data        |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
    </Accordion>

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

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

    <Accordion title="Applications">
      | Field                        | Notes |
      | ---------------------------- | ----- |
      | id                           |       |
      | remote\_id                   |       |
      | changed\_at                  |       |
      | remote\_deleted\_at          |       |
      | outcome                      |       |
      | current\_stage\_id           |       |
      | job\_id                      |       |
      | candidate\_id                |       |
      | screening\_question\_answers |       |
      | custom\_fields               |       |
      | integration\_fields          |       |
      | remote\_updated\_at          |       |
      | remote\_data                 |       |
    </Accordion>

    <Accordion title="Screening questions">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | title               |       |
      | description         |       |
      | format              |       |
    </Accordion>

    <Accordion title="Tags">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
    </Accordion>

    <Accordion title="Interviews">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | starting\_at        |       |
      | ending\_at          |       |
      | application\_id     |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Rejection reasons">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Roles">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | remote\_label       |       |
      | scope               |       |
      | unified\_type       |       |
    </Accordion>

    <Accordion title="Candidate tags">
      | Field               | Notes |
      | ------------------- | ----- |
      | candidate\_id       |       |
      | tag\_id             |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>

    <Accordion title="Job-specific screening questions">
      | Field                      | Notes |
      | -------------------------- | ----- |
      | index                      |       |
      | required                   |       |
      | precondition\_question\_id |       |
      | precondition\_options      |       |
      | job\_id                    |       |
      | question\_id               |       |
      | id                         |       |
      | changed\_at                |       |
      | remote\_deleted\_at        |       |
    </Accordion>

    <Accordion title="Job user role assignments">
      <Note>
        SuccessFactors requisition exposes 5 types of roles for a job

        * **hiringManager** (shown as "Hiring Manager" in the UI) maps to `HIRING_MANAGER`
        * **hiringManagerTeam** (shown as "Hiring Manager Team" in the UI) maps to `HIRING_MANAGER`
        * **recruiter** (shown as "Recruiter" in the UI) maps to `RECRUITER`
        * **recruiterTeam** (shown as "Recruiting Team" in the UI) maps to `RECRUITER`
        * Users from **Recruiting Team** are only included when the include\_recruiting\_team\_in\_hiring\_team setting is enabled.
        * **currentOwner** has no unified type
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | job\_user\_id       |       |
      | role\_id            |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>

    <Accordion title="Job hiring team members">
      | Field               | Notes |
      | ------------------- | ----- |
      | roles               |       |
      | job\_id             |       |
      | user\_id            |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create candidate">
      | Input Field                               | Notes |
      | ----------------------------------------- | ----- |
      | candidate.first\_name                     |       |
      | candidate.last\_name                      |       |
      | candidate.email\_address                  |       |
      | candidate.company                         |       |
      | candidate.title                           |       |
      | candidate.phone\_number                   |       |
      | candidate.location.city                   |       |
      | candidate.location.country                |       |
      | candidate.location.street\_1              |       |
      | candidate.location.zip\_code              |       |
      | candidate.gender                          |       |
      | candidate.availability\_date              |       |
      | candidate.salary\_expectations.period     |       |
      | candidate.salary\_expectations.amount     |       |
      | application.job\_id                       |       |
      | application.stage\_id                     |       |
      | screening\_question\_answers.question\_id |       |
      | screening\_question\_answers.answer       |       |
      | attachments.name                          |       |
      | attachments.content\_type                 |       |
      | attachments.data\_url                     |       |
      | attachments.data                          |       |
      | attachments.type                          |       |
      | source.name                               |       |
      | source.unified\_key                       |       |
      | source.id                                 |       |
      | gdpr\_consent.given                       |       |
    </Accordion>

    <Accordion title="Create application">
      | Input Field                               | Notes |
      | ----------------------------------------- | ----- |
      | candidate.first\_name                     |       |
      | candidate.last\_name                      |       |
      | candidate.email\_address                  |       |
      | candidate.company                         |       |
      | candidate.title                           |       |
      | candidate.phone\_number                   |       |
      | candidate.location.city                   |       |
      | candidate.location.country                |       |
      | candidate.location.street\_1              |       |
      | candidate.location.zip\_code              |       |
      | candidate.gender                          |       |
      | candidate.availability\_date              |       |
      | candidate.salary\_expectations.period     |       |
      | candidate.salary\_expectations.amount     |       |
      | application.job\_id                       |       |
      | application.stage\_id                     |       |
      | screening\_question\_answers.question\_id |       |
      | screening\_question\_answers.answer       |       |
      | attachments.name                          |       |
      | attachments.content\_type                 |       |
      | attachments.data\_url                     |       |
      | attachments.data                          |       |
      | attachments.type                          |       |
      | source.name                               |       |
      | source.unified\_key                       |       |
      | source.id                                 |       |
      | gdpr\_consent.given                       |       |
    </Accordion>

    <Accordion title="Add tag to candidate">
      | Input Field   | Notes |
      | ------------- | ----- |
      | candidate\_id |       |
      | tag.name      |       |
    </Accordion>

    <Accordion title="Remove tag from candidate">
      | Input Field   | Notes |
      | ------------- | ----- |
      | candidate\_id |       |
      | tag.name      |       |
    </Accordion>

    <Accordion title="Add attachment to application">
      | Input Field              | Notes |
      | ------------------------ | ----- |
      | application\_id          |       |
      | attachment.name          |       |
      | attachment.content\_type |       |
      | attachment.data\_url     |       |
      | attachment.data          |       |
      | attachment.type          |       |
    </Accordion>

    <Accordion title="Move application to stage">
      <Note>
        It is only possible to move applications to stages where there is at least 1 application already. This means you have to manually move at least 1 application into the stage first and then move an application into that stage via the Kombo API.
      </Note>

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

    <Accordion title="Reject application">
      | Input Field           | Notes |
      | --------------------- | ----- |
      | application\_id       |       |
      | rejection\_reason\_id |       |
    </Accordion>

    <Accordion title="Add result link to application">
      | 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>
        Comment limit for SuccessFactors is 4000 characters.
      </Note>

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

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

    <Accordion title="Add result link to candidate">
      | Input Field                         | Notes |
      | ----------------------------------- | ----- |
      | candidate\_id                       |       |
      | label                               |       |
      | url                                 |       |
      | details.custom\_field\_name\_prefix |       |
      | details.attributes.key              |       |
      | details.attributes.value            |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature                                | Notes                                                         |
    | -------------------------------------- | ------------------------------------------------------------- |
    | Source Writing                         |                                                               |
    | Sync Only Created Applications         |                                                               |
    | Connection Guide                       |                                                               |
    | Prerequisites                          |                                                               |
    | Create credentials                     |                                                               |
    | Candidate source tracking              |                                                               |
    | Create Candidate Full Attachment Retry |                                                               |
    | Roles                                  |                                                               |
    | Job roles (e.g. Hiring Manager)        | SuccessFactors requisition exposes 5 types of roles for a job |

    * **hiringManager** (shown as "Hiring Manager" in the UI) maps to `HIRING_MANAGER`
    * **hiringManagerTeam** (shown as "Hiring Manager Team" in the UI) maps to `HIRING_MANAGER`
    * **recruiter** (shown as "Recruiter" in the UI) maps to `RECRUITER`
    * **recruiterTeam** (shown as "Recruiting Team" in the UI) maps to `RECRUITER`
    * Users from **Recruiting Team** are only included when the include\_recruiting\_team\_in\_hiring\_team setting is enabled.
    * **currentOwner** has no unified type |
      \| API Passthrough |  |
      \|   Additional Scopes |  |
      \| Scope Testing |  |
      \| Delta Syncs |  |
      \| Custom Field Explorer |  |
      \|   Jobs |  |
      \|   Candidates |  |
      \| EEO Questions | EEO data is typically collected through Job Application Templates. Contact our support team for guidance on setting this up. We are unable to automatically detect which questions are EEO-related. As a result, EEO questions will have a category of `null`. |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** SAP SuccessFactors

For **SAP SuccessFactors**, we also offer the following other connector variants:

<CardGroup cols={2}>
  <Card title="SAP SuccessFactors Assessment" icon="https://storage.googleapis.com/kombo-assets/integrations/successfactors/icon.svg" href="/assessment/connectors/successfactors">
    SAP SuccessFactors for the Assessment category
  </Card>

  <Card title="SAP SuccessFactors HRIS" icon="https://storage.googleapis.com/kombo-assets/integrations/successfactors/icon.svg" href="/hris/connectors/successfactors">
    SAP SuccessFactors for the HRIS category
  </Card>

  <Card title="SAP SuccessFactors LMS" icon="https://storage.googleapis.com/kombo-assets/integrations/successfactors/icon.svg" href="/lms/connectors/successfactors">
    SAP SuccessFactors for the LMS category
  </Card>
</CardGroup>