KOkombo
AI Apply

Create application

Changed on

Deprecation Notice: This endpoint is no longer actively supported. Please use the standard AI Apply API instead. Create applications in a backwards compatible way as you would via Kombo's unified API.

post/ai-apply/unified-api/jobs/{job_id}/applications

Request

Path parameters

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

Request body

stage_idstring

Stage this candidate should be in. If left out, the default stage for this job will be used. You can obtain the possible stage_ids from the get-jobs endpoint.

query_paramsobject

Query parameters to be appended to the job posting URL when applying.

Example request

{
  "screening_question_answers": [
    {
      "question_id": "D8yPrjXXvA2XeBksTmrVvKSn",
      "answer": "Yes"
    }
  ]
}

Response

POST /ai-apply/unified-api/jobs/:job_id/applications Positive response

status'success' required

Example response

{
  "data": {
    "id": "H77fDF8uvEzGNPRubiz5DvQ7",
    "remote_id": "32",
    "outcome": "PENDING",
    "rejection_reason_name": null,
    "rejected_at": null,
    "current_stage_id": "5J7L4b48wBfffYwek9Az9pkM",
    "job_id": "H5daSm8e85Dmvmne3wLeCPhX",
    "candidate_id": "26vafvWSRmbhNcxJYqjCzuJg",
    "screening_question_answers": [],
    "custom_fields": {},
    "integration_fields": [],
    "remote_url": "https://example.com/applications/32",
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null,
    "remote_created_at": "2022-04-02T00:00:00.000Z",
    "remote_updated_at": "2022-04-04T00:00:00.000Z",
    "remote_data": null,
    "current_stage": {
      "id": "5J7L4b48wBfffYwek9Az9pkM",
      "name": "Interview",
      "remote_id": "5",
      "index": 2
    },
    "job": {
      "id": "H5daSm8e85Dmvmne3wLeCPhX",
      "name": "Head of Integrations",
      "remote_id": "1"
    },
    "candidate": {
      "id": "26vafvWSRmbhNcxJYqjCzuJg",
      "remote_id": "32",
      "first_name": "John",
      "last_name": "Doe",
      "company": "Acme, Inc.",
      "title": "Head of Marketing",
      "confidential": false,
      "source": "Employee Referral",
      "phone_numbers": [
        {
          "phone_number": "+1-541-754-3010",
          "type": "HOME"
        }
      ],
      "email_addresses": [
        {
          "email_address": "john.doe@example.com",
          "type": "PRIVATE"
        }
      ],
      "social_media": [
        {
          "link": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
          "type": "YOUTUBE",
          "username": null
        }
      ],
      "location": {
        "city": "Berlin",
        "country": "DE",
        "raw": "Berlin, Germany",
        "state": "Berlin",
        "street_1": "Lohmühlenstraße 65",
        "street_2": null,
        "zip_code": "12435"
      },
      "custom_fields": {},
      "integration_fields": [],
      "remote_url": "https://example.com/candidates/32",
      "remote_created_at": "2022-04-02T00:00:00.000Z",
      "remote_updated_at": "2022-04-04T00:00:00.000Z",
      "remote_data": null,
      "changed_at": "2022-04-04T00:00:00.000Z",
      "remote_deleted_at": null,
      "tags": [
        {
          "id": "7DHDky9zk4qnWkycuuQjFXNh",
          "name": "Fast Learner",
          "remote_id": "1"
        }
      ]
    }
  }
}

Changes