POST
/
ats
/
jobs
/
{job_id}
/
applications
curl --request POST \
  --url https://api.kombo.dev/v1/ats/jobs/{job_id}/applications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '{
  "candidate": {
    "first_name": "Frank",
    "last_name": "Doe",
    "company": "Acme Inc.",
    "title": "Head of Integrations",
    "email_address": "frank.doe@example.com",
    "phone_number": "+1-541-754-3010",
    "gender": "MALE",
    "salary_expectations": {
      "amount": 100000,
      "period": "YEAR"
    },
    "availability_date": "2021-01-01",
    "location": {
      "city": "New York",
      "country": "US"
    }
  },
  "stage_id": "8x3YKRDcuRnwShdh96ShBNn1",
  "attachments": [
    {
      "name": "Frank Doe CV.txt",
      "data": "SGkgdGhlcmUsIEtvbWJvIGlzIGN1cnJlbnRseSBoaXJpbmcgZW5naW5lZXJzIHRoYXQgbG92ZSB0byB3b3JrIG9uIGRldmVsb3BlciBwcm9kdWN0cy4=",
      "type": "CV",
      "content_type": "text/plain"
    }
  ],
  "screening_question_answers": [
    {
      "question_id": "3phFBNXRweGnDmsU9o2vdPuQ",
      "answer": "Yes"
    },
    {
      "question_id": "EYJjhMQT3LtVKXnTbnRT8s6U",
      "answer": [
        "GUzE666zfyjeoCJX6A8n7wh6",
        "5WPHzzKAv8cx97KtHRUV96U8",
        "7yZfKGzWigXxxRTygqAfHvyE"
      ]
    }
  ]
}'
{
  "status": "success",
  "data": {
    "id": "<string>",
    "remote_id": "<string>",
    "outcome": "PENDING",
    "rejection_reason_name": "<string>",
    "rejected_at": "2023-11-07T05:31:56Z",
    "current_stage_id": "<string>",
    "job_id": "<string>",
    "candidate_id": "<string>",
    "screening_question_answers": [],
    "custom_fields": {},
    "integration_fields": [
      {
        "id": "5NVFhMpB9Ah6by44tzNjZLyE",
        "key": "firstName",
        "type": "DEFAULT",
        "value": "Frank",
        "label": "First Name"
      },
      {
        "id": "8nuajYpoRd5GnxEQaaWKUDYQ",
        "key": "customTshirtSize",
        "type": "CUSTOM",
        "value": "XL",
        "label": "T-Shirt Size"
      }
    ],
    "changed_at": "2023-11-07T05:31:56Z",
    "remote_deleted_at": "2023-11-07T05:31:56Z",
    "remote_created_at": "2023-11-07T05:31:56Z",
    "remote_updated_at": "2023-11-07T05:31:56Z",
    "remote_data": {},
    "current_stage": {
      "id": "<string>",
      "name": "<string>",
      "remote_id": "<string>",
      "index": 2
    },
    "job": {
      "id": "H5daSm8e85Dmvmne3wLeCPhX",
      "name": "Backend Engineer",
      "remote_id": "32"
    },
    "candidate": {
      "id": "<string>",
      "remote_id": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "company": "<string>",
      "title": "<string>",
      "confidential": true,
      "source": "<string>",
      "phone_numbers": [],
      "email_addresses": [],
      "social_media": [],
      "location": {
        "city": "<string>",
        "country": "<string>",
        "raw": "<string>",
        "state": "<string>",
        "street_1": "<string>",
        "street_2": "<string>",
        "zip_code": "<string>"
      },
      "custom_fields": {},
      "integration_fields": [
        {
          "id": "5NVFhMpB9Ah6by44tzNjZLyE",
          "key": "firstName",
          "type": "DEFAULT",
          "value": "Frank",
          "label": "First Name"
        },
        {
          "id": "8nuajYpoRd5GnxEQaaWKUDYQ",
          "key": "customTshirtSize",
          "type": "CUSTOM",
          "value": "XL",
          "label": "T-Shirt Size"
        }
      ],
      "remote_created_at": "2023-11-07T05:31:56Z",
      "remote_updated_at": "2023-11-07T05:31:56Z",
      "remote_data": {},
      "changed_at": "2023-11-07T05:31:56Z",
      "remote_deleted_at": "2023-11-07T05:31:56Z",
      "tags": [
        {
          "id": "26vafvWSRmbhNcxJYqjCzuJg",
          "name": "High Potential",
          "remote_id": "32"
        }
      ]
    }
  },
  "warnings": [
    {
      "message": "<string>"
    }
  ]
}

Visit our in depth guide to learn more about:

This endpoint requires the permission Create applications and candidates to be enabled in your scope config.

​
Example Request Body

{
  "candidate": {
    "first_name": "Frank",
    "last_name": "Doe",
    "company": "Acme Inc.",
    "title": "Head of Integrations",
    "email_address": "frank.doe@example.com",
    "phone_number": "+1-541-754-3010",
    "gender": "MALE",
    "salary_expectations": {
      "amount": 100000,
      "period": "YEAR"
    },
    "availability_date": "2021-01-01",
    "location": {
      "city": "New York",
      "country": "US"
    }
  },
  "stage_id": "8x3YKRDcuRnwShdh96ShBNn1",
  "attachments": [
    {
      "name": "Frank Doe CV.txt",
      "data": "SGkgdGhlcmUsIEtvbWJvIGlzIGN1cnJlbnRseSBoaXJpbmcgZW5naW5lZXJzIHRoYXQgbG92ZSB0byB3b3JrIG9uIGRldmVsb3BlciBwcm9kdWN0cy4=",
      "type": "CV",
      "content_type": "text/plain"
    }
  ],
  "screening_question_answers": [
    {
      "question_id": "3phFBNXRweGnDmsU9o2vdPuQ",
      "answer": "Yes"
    },
    {
      "question_id": "EYJjhMQT3LtVKXnTbnRT8s6U",
      "answer": [
        "GUzE666zfyjeoCJX6A8n7wh6",
        "5WPHzzKAv8cx97KtHRUV96U8",
        "7yZfKGzWigXxxRTygqAfHvyE"
      ]
    }
  ],
  "remote_fields": {}
}

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.

Path Parameters

​
job_id
string
required

The Kombo ID or Remote ID of the Job this candidate should apply for. If you want to use the ID of the integrated system (remote_id) you need to prefix the id with "remote:". You can use the remote ID if you do not want to sync jobs.

Body

application/json
POST /ats/jobs/:job_id/applications request body

The body is of type object.

Response

200
application/json
POST /ats/jobs/:job_id/applications Successful response

The response is of type object.