Sign in

v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB
Ats > Feedback

Creates a Feedback

This endpoint allows to create new feedback entries for candidates.

post/api/2026-07-01/resources/ats/feedbacks

Request body

ats_candidate_idstring required

the ID of the candidate to whom the new feedback will be associated.

ratinginteger

the overall rating from 1 to 5 to be given to the candidate's application.

ats_application_idstring

the ID of the application related to the feedback.

ats_application_phase_idstring

the ID of the phase within the application related to the feedback.

descriptionstring

a string describing the feedback provided.

mention_idsstring[]

the IDs of the accesses for sending notifications if they have it enabled. They must have permissions to see the assosiated application.

ats_evaluation_forms_idstring

IDs of the form to which the feedback belongs if the evaluation forms feature is active.

Example request

{
  "ats_candidate_id": "1",
  "rating": 4,
  "ats_application_id": "1",
  "ats_application_phase_id": "1",
  "description": "The candidate has a great attitude and is a good fit for the team.",
  "mention_ids": [
    "1",
    "2",
    "3"
  ],
  "ats_evaluation_forms_id": "[1, 2, 3]"
}

Response

CREATED

idstring required

the ID of the feedback entry.

ratinginteger

the overall rating from 1 to 5 for the candidate's application.

descriptionstring

the description of the feedback provided.

ats_application_idstring

the ID of the application related to the feedback.

ats_application_phase_idstring

the ID of the phase within the application related to the feedback.

created_atstring required

the date and time when the feedback entry was created.

ats_candidate_idstring required

the ID of the candidate to whom the feedback is associated.

ats_evaluation_forms_idstring

the ID of the evaluation form to which the feedback belongs if the evaluation forms feature is active.

Example response

{
  "id": "1",
  "rating": 4,
  "description": "The candidate has a great attitude and is a good fit for the team.",
  "ats_application_id": "1",
  "ats_application_phase_id": "1",
  "created_at": "2022-01-01T00:00:00Z",
  "ats_candidate_id": "1",
  "ats_evaluation_forms_id": "1",
  "evaluation_form_answers": [
    {
      "id": 1,
      "score": 3,
      "note": "Good communication skills."
    }
  ]
}