KOkombo
Unified ATS API

Add attachment to candidate

Changed on

Uploads an attachment file for the specified candidate.

<Warning> **We recommend using the [add attachment to application](/ats/v1/post-applications-application-id-attachments) endpoint instead.**

We realized that in practice it was always more about adding attachments to applications instead of candidates, so we created a new, more aptly named one that you should use instead: add attachment to application </Warning>

<Note> This endpoint requires the permission **Add attachments** to be enabled in [your scope config](/scopes). </Note>

Example Request Body

{
  "candidate_id": "GRKdd9dibYKKCrmGRSMJf3wu",
  "attachment": {
    "name": "Frank Doe CV.txt",
    "data": "SGkgdGhlcmUsIEtvbWJvIGlzIGN1cnJlbnRseSBoaXJpbmcgZW5naW5lZXJzIHRoYXQgbG92ZSB0byB3b3JrIG9uIGRldmVsb3BlciBwcm9kdWN0cy4=",
    "type": "CV",
    "content_type": "text/plain"
  }
}
post/ats/candidates/{candidate_id}/attachments

Request

Path parameters

candidate_idstring required

The Kombo ID of the candidate you want to add the attachment to.

Headers

X-Integration-Idstring required

ID of the integration you want to interact with.

Request body

Response

POST /ats/candidates/:candidate_id/attachments Positive response

status'success' required
dataobject required

Changes

  • d0e06abf1118Revision changes
    • breaking

      added the new required request property

    • breaking

      the request's body type changed from no type to object

    • warning

      removed subschema #1 from the request body allOf list

    • info

      added the new optional request property

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      the response property const value success was added for the status

    • info

      removed the success enum value from the response property for the response status

    • info

      added the required property to the response with the status