Python

from kombo import SDK
from kombo.utils import parse_datetime


with SDK(
    integration_id="workday:HWUTwvyx2wLoSUHphiWVrp28",
    api_key="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.ats.import_tracked_application(tracked_at=parse_datetime("2024-04-12T14:33:47Z"), successfactors={
        "id_type": "application_remote_id",
        "application_remote_id": "1224042",
    })

    # Handle response
    print(res)

{
  "status": "success",
  "data": {
    "id": "5wdtQtJei2oVhJKya2V1KZLM",
    "tracked_at": "2025-02-11T15:37:37.000Z",
    "imported_id": {
      "successfactors": {
        "id_type": "application_remote_id",
        "application_remote_id": "1224042"
      }
    }
  },
  "warnings": [
    {
      "message": "This is an example warning!"
    }
  ]
}

Unified ATS API

Import tracked application

Supported integrations

This feature is currently available for the following integrations:

You’d like to see this feature for another integration? Please reach out! We’re always happy to discuss extending our coverage.

Retroactively import existing applications into Kombo’s tracking system. This is particularly useful if you have enabled the ‘sync only created applications’ setting and want to start tracking applications that were created before using Kombo.

To import an application, you’ll need to provide specific identifiers based on the ATS. The available id_type values are defined by Kombo based on the tool’s API capabilities. Please reach out to Kombo support if you require further types to be supported.

Once imported, Kombo will automatically fetch and update the application’s complete data during the next sync.

Example Request Body

{
  "tracked_at": "2024-04-12T14:33:47.000Z",
  "successfactors": {
    "id_type": "application_remote_id",
    "application_remote_id": "1224042"
  }
}

POST

ats

import-tracked-application

Python

from kombo import SDK
from kombo.utils import parse_datetime


with SDK(
    integration_id="workday:HWUTwvyx2wLoSUHphiWVrp28",
    api_key="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.ats.import_tracked_application(tracked_at=parse_datetime("2024-04-12T14:33:47Z"), successfactors={
        "id_type": "application_remote_id",
        "application_remote_id": "1224042",
    })

    # Handle response
    print(res)

{
  "status": "success",
  "data": {
    "id": "5wdtQtJei2oVhJKya2V1KZLM",
    "tracked_at": "2025-02-11T15:37:37.000Z",
    "imported_id": {
      "successfactors": {
        "id_type": "application_remote_id",
        "application_remote_id": "1224042"
      }
    }
  },
  "warnings": [
    {
      "message": "This is an example warning!"
    }
  ]
}

Authorizations

Authorization

string

header

required

Create an API key on the Secrets page in the Kombo dashboard.

Headers

X-Integration-Id

string

required

ID of the integration you want to interact with.

Body

application/json

POST /ats/import-tracked-application Request body

tracked_at

string<date-time> | null

required

YYYY-MM-DDTHH:mm:ss.sssZ

erecruiter

object

Option 1
Option 2

Show child attributes

successfactors

object

Show child attributes

recruitee

object

Show child attributes

greenhouse

object

Show child attributes

onlyfy

object

Show child attributes

smartrecruiters

object

Show child attributes

Response

POST /ats/import-tracked-application Positive response

status

string

required

Allowed value: "success"

data

object

required

Show child attributes

Examples:

{
  "id": "5wdtQtJei2oVhJKya2V1KZLM",
  "tracked_at": "2025-02-11T15:37:37.000Z",
  "imported_id": {
    "successfactors": {
      "id_type": "application_remote_id",
      "application_remote_id": "1224042"
    }
  }
}

warnings

object[]

required

These are the interaction warnings that are shown in the dashboard. They are meant to provide debug information to you. We recommend logging them to the console.

Show child attributes

Get atsactionsats add candidate attachment Get packages

⌘I

General

General

Unified HRIS API

Unified ATS API

Unified ATS (Assessment & Background Check) API

AI Apply

Kombo Connect

Custom Endpoints

API Reference

Import tracked application

Example Request Body

Authorizations

Headers

Body

Response