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

# Softgarden ATS Integration

> Softgarden connector for Kombo's ATS API

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

## Guides and Resources

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

  <Card title="Source Setup Guide" icon="settings" href="https://help.kombo.dev/hc/en-us/articles/30574515999249-Softgarden-How-do-I-link-my-account-New-Design#:~:text=Set%20up%20source%20writing%20(conditional)">
    Learn how to set up candidate sources in Softgarden.
  </Card>

  <Card title="Connection guide (old design)" icon="book" href="https://help.kombo.dev/hc/en-us/articles/17889584793745">
    Additional documentation and guides for Softgarden.
  </Card>

  <Card title="Source setup guide (old design)" icon="book" href="https://help.kombo.dev/hc/en-us/articles/27756023403025">
    Additional documentation and guides for Softgarden.
  </Card>
</CardGroup>

## General Notes

* Softgarden does not support reading or interacting with candidates.

## 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               |       |
    </Accordion>

    <Accordion title="Jobs">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | job\_code           |       |
      | description         |       |
      | employment\_type    |       |
      | status              |       |
      | visibility          |       |
      | category            |       |
      | post\_url           |       |
      | experience\_level   |       |
      | location            |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | opened\_at          |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
      | contact\_id         |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Application Stages">
      <Note>
        We can only retrieve application stages from applications. That means, unless an application that we fetch is in a given stage, we won't return that stage on the API. This is a limitation of the Softgarden API.
      </Note>

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

    <Accordion title="Applications">
      <Note>
        Softgarden only allows reading applications that were created through the Kombo API.
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | outcome             |       |
      | current\_stage\_id  |       |
      | job\_id             |       |
      | candidate\_id       |       |
      | remote\_url         |       |
      | remote\_data        |       |
    </Accordion>

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

    <Accordion title="Job-specific application stages">
      | Field               | Notes |
      | ------------------- | ----- |
      | index               |       |
      | job\_id             |       |
      | stage\_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 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.gender                          |       |
      | application.job\_id                       |       |
      | screening\_question\_answers.question\_id |       |
      | screening\_question\_answers.answer       |       |
      | attachments.name                          |       |
      | 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.gender                          |       |
      | application.job\_id                       |       |
      | screening\_question\_answers.question\_id |       |
      | screening\_question\_answers.answer       |       |
      | attachments.name                          |       |
      | attachments.data\_url                     |       |
      | attachments.data                          |       |
      | attachments.type                          |       |
      | source.name                               |       |
      | source.unified\_key                       |       |
      | source.id                                 |       |
      | gdpr\_consent.given                       |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature                        | Notes |
    | ------------------------------ | ----- |
    | Source Writing                 |       |
    | Sync Only Created Applications |       |
    | Connection Guide               |       |
    | Prerequisites                  |       |
    | Create credentials             |       |
    | API Passthrough                |       |
    | Custom Field Explorer          |       |
    | Jobs                           |       |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** Choose this variant if you want to use the regular Softgarden API

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

<CardGroup cols={2}>
  <Card title="Softgarden Partner" icon="https://storage.googleapis.com/kombo-assets/integrations/softgardenpartner/icon.svg" href="/ats/connectors/softgardenpartner">
    Choose this variant if you are a Softgarden partner and want to use the XML feed API
  </Card>
</CardGroup>

<Note>Multiple variants can be used within your Kombo environment at the same time.</Note>