FAfactorialhr
Ats > Feedback

Creates a Feedback

Changed on

This endpoint allows to create new feedback entries for candidates.

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

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/ats/feedbacks
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: recruitment
    • or API key in header x-api-key

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."
    }
  ]
}

Changes