---
title: "Import tracked application"
method: POST
path: "/ats/import-tracked-application"
tags: ["Unified ATS API"]
---

# Import tracked application

`POST /ats/import-tracked-application`

Import tracked application

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

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

## Headers

- `X-Integration-Id` string, required

## Request body

- PostAtsImportTrackedApplicationRequestBody
  - `erecruiter` union
    - object
      - `id_type` 'application_and_job_remote_ids', required — Uses the `Api/Applications/ByJob/{jobId}` endpoint to retrieve the relevant application based on the job ID.
      - `application_remote_id` string, required
      - `job_remote_id` string, required
    - object
      - `id_type` 'application_and_candidate_remote_ids', required — Uses the `Api/Applications/{applicantId}` endpoint to retrieve the relevant application based on the candidate ID.
      - `candidate_remote_id` string, required
      - `application_remote_id` string, required
  - `successfactors` object
    - `id_type` 'application_remote_id', required — Uses the `/JobApplication` ODATA endpoint to retrieve the relevant application based on the application ID.
    - `application_remote_id` string, required
  - `recruitee` object
    - `id_type` 'placement_id', required — Uses the `/candidates` endpoint to retrieve all candidates, to find the relevant application based on the placement ID.
    - `placement_id` string, required
  - `greenhouse` object
    - `id_type` 'application_id', required — Uses the `/applications/{id}` endpoint to retrieve the application.
    - `application_id` string, required
  - `greenhousev3` object
    - `id_type` 'application_id', required — Uses the V3 `/v3/applications/{id}` endpoint to retrieve the application.
    - `application_id` string, required
  - `onlyfy` object
    - `id_type` 'application_id', required — Uses the `/v1/application/{id}` endpoint to retrieve the application.
    - `application_id` string, required
  - `smartrecruiters` object
    - `id_type` 'candidate_and_job_remote_ids', required — Uses the `/candidates/{candidateId}/jobs/{jobId}` endpoint to retrieve the application.
    - `candidate_remote_id` string, required
    - `job_remote_id` string, required
  - `tracked_at` string, date-time, nullable, required — YYYY-MM-DDTHH:mm:ss.sssZ

## Response `200`

POST /ats/import-tracked-application Positive response

- PostAtsImportTrackedApplicationPositiveResponse
  - `status` 'success', required
  - `data` object, required
    - `id` string, required
    - `tracked_at` string, date-time, nullable, required — YYYY-MM-DDTHH:mm:ss.sssZ
    - `imported_id` object, required
      - `erecruiter` union
        - object
          - `id_type` 'application_and_job_remote_ids', required — Uses the `Api/Applications/ByJob/{jobId}` endpoint to retrieve the relevant application based on the job ID.
          - `application_remote_id` string, required
          - `job_remote_id` string, required
        - object
          - `id_type` 'application_and_candidate_remote_ids', required — Uses the `Api/Applications/{applicantId}` endpoint to retrieve the relevant application based on the candidate ID.
          - `candidate_remote_id` string, required
          - `application_remote_id` string, required
      - `successfactors` object
        - `id_type` 'application_remote_id', required — Uses the `/JobApplication` ODATA endpoint to retrieve the relevant application based on the application ID.
        - `application_remote_id` string, required
      - `recruitee` object
        - `id_type` 'placement_id', required — Uses the `/candidates` endpoint to retrieve all candidates, to find the relevant application based on the placement ID.
        - `placement_id` string, required
      - `greenhouse` object
        - `id_type` 'application_id', required — Uses the `/applications/{id}` endpoint to retrieve the application.
        - `application_id` string, required
      - `greenhousev3` object
        - `id_type` 'application_id', required — Uses the V3 `/v3/applications/{id}` endpoint to retrieve the application.
        - `application_id` string, required
      - `onlyfy` object
        - `id_type` 'application_id', required — Uses the `/v1/application/{id}` endpoint to retrieve the application.
        - `application_id` string, required
      - `smartrecruiters` object
        - `id_type` 'candidate_and_job_remote_ids', required — Uses the `/candidates/{candidateId}/jobs/{jobId}` endpoint to retrieve the application.
        - `candidate_remote_id` string, required
        - `job_remote_id` string, required
  - `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.
    - `message` string, required

## Other responses

- `default` — The standard error response with the error codes for the ATS use case.

---

[API](https://skmtc.net/kombo/apis/kombo-api.md) · [All operations](https://skmtc.net/kombo/apis/kombo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kombo/kombo-api/versions/1e45035b96d3/schema)