POST
/
ats
/
applications
/
{application_id}
/
reject
Reject application
curl --request POST \
  --url https://api.kombo.dev/v1/ats/applications/{application_id}/reject \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '{
  "rejection_reason_id": "3PJ8PZhZZa1eEdd2DtPNtVup",
  "note": "Candidate was a great culture fit but didn'\''t bring the hard skills we need."
}'
{
  "status": "<string>",
  "data": {},
  "warnings": [
    {
      "message": "<string>"
    }
  ]
}
Rejects an application with a provided reason. Optionally, you can provide a free text note. You can get the list of rejection reasons with our Get rejection reasons endpoint.
This endpoint requires the permission Reject applications to be enabled in your scope config.

​
Example Request Body

{
  "rejection_reason_id": "3PJ8PZhZZa1eEdd2DtPNtVup",
  "note": "Candidate was a great culture fit but didn't bring the hard skills we need.",
  "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

​
application_id
string
required

The Kombo ID of the application you want to reject.

Body

application/json

POST /ats/applications/:application_id/reject Request body

​
rejection_reason_id
string
required

The Kombo ID of the rejection reason.

​
note
string

A optional free text rejection note. Passed through if possible.

​
remote_fields
object

Additional fields that we will pass through to specific ATS systems.

Response

POST /ats/applications/:application_id/reject Positive response

​
status
string
required
Allowed value: "success"
​
data
object
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.