Partager via


Sync Application Interview Feedback

Application interview feedback should be sent via the Middleware Platform whenever they are created or updated in your ATS. Use both your application identifier and interview feedback identifier when syncing application interview feedback via API.

Throttle Limits

Throttle Limits Requests Per Day (UTC) Records Per Minute
Application maximum 100,000 10,000

Note

Please submit batch calls grouped with no more than 100 records in sequential order.

Sync Application Interview Feedback

Use the following endpoint to create and update application interview feedback:

PUT https://api.linkedin.com/v2/atsApplications/atsJobApplicationId={id1}&dataProvider=ATS&integrationContext={organization URN}/interviewFeedback?ids=INTFB123&ids=INTFB456

Request Body Fields

Field Description Format Required
atsCreatedAt Date record was created in your ATS UTC Epoch Milliseconds No
interviewer The person who interviewed the candidate and wrote this evaluation. Actor No
evaluations A list of final evaluations for this interview. Example of evaluations would be a final recommendation or an interview score. InterviewEvaluation[] No
feedback General feedback about the interview. string No
interviewType Indicates which type of the interview the feedback was for. Possible values are: PHONE_SCREEN or ONSITE No

Actor Schema

Field Description Format Required
firstName The first name of the actor. String Required
lastName The last name of the actor String Required

InterviewEvaluation Schema

Field Description Format Required
attribute The descriptive name about the qualification the candidate was evaluated for, for example "Verbal Communication", "Technical Qualifications". String Required
result The result of the evaluation, could be a final recommendation or an interview score. String Optional

Sample Request

Headers:

Authorization: Bearer {token}
x-restli-method: batch_update

Request Body:

{
  "entities": {
    "INTFB123": {
      "atsCreatedAt": 1484864187000,
      "evaluations": [
        {
          "attribute": "Verbal Communication",
          "result": "4/5"
        }
      ],
      "feedback": "Lorem Ipsum.",
      "interviewer": {
        "firstName": "Angela",
        "lastName": "Smith"
      },
      "interviewType": "PHONE_SCREEN"
    },
    "INTFB456": {
      "atsCreatedAt": 1484864187000,
      "evaluations": [
        {
          "attribute": "Culture Fit",
          "result": "Good fit"
        }
      ],
      "feedback": "Lorem Ipsum moreum.",
      "interviewer": {
        "firstName": "Bobby",
        "lastName": "Hill"
      },
      "interviewType": "ONSITE"
    }
  }
}

Sample Response

A successful request will return a 200 OK response code, and you will find the status of each entity in the response body.

Sample Response Body

{
    "errors": {},
    "results": {
        "INTFB123": {
            "status": 204
        },
        "INTFB456": {
            "status": 204
        }
    }
}

Note

  • Be sure to check the response for error statuses corresponding to individual entities you submit.

Delete Application Interview Feedback

API Details

Perform HTTP DELETE on the endpoint /atsApplications/{JobApplicationIdentifier}/interviewFeedback to delete interviews. More information is available here.