Accept / Reject assessment orders

Accept assessment order

Accepting the assessment order is the first step to begin working on your order. You can accept the assessment order by passing the AssessmentComment object to the following endpoint,

curl -i -H "X-SmartToken:abc123" -H "Content-Type: application/json;charset=utf-8" -d @body.json -X POST https://api.smartrecruiters.com/v1/assessments/511a3942300469a9c33819d1/accept

body.json:

1
2
3
4
5
6
7
8
9
10
11
{
    "message": "We are starting work on this. This assessment should take about 3 business days.",
    "assessmentURL": "https://assessmentvendor.com/start-assessment/sdf32k23ll43",
    "messageToCandidate": "Hi Mark, Orlando Magic Inc. asked us to perform an assessment for you. Please follow steps under the below link: https://assessmentvendor.com/start-assessment/sdf32k23ll43. Wish you luck!",
    "author": {
        "firstName": "John",
        "lastName": "Mnemonic",
        "email": "john.mnemonic@smartrecruiters.com",
        "phone": "(123) 321 32 1231"
    }
}

Please remember to pass a URL to take an assessment together with a message containing any instructions (although all instructions should be placed on a landing page when taking an assessment). These information will be surfaced on a Candidate Portal in the futue.

Note: surfacing the message in the Candidate Portal is going to be an additional channel to notify candidate. You as a partner, should still send an email to a candidate once order is accepted with an appropriate message and a link to the assessment. SmartRecruiters will NOT send any emails to the candidate related to the assessment order.

On accepting the request, the status of assessment order changes from NEW to IN_PROGRESS.

Reject assessment order

To reject an assessment order, you can send the following POST request,

curl -i -H "X-SmartToken:abc123" -H "Content-Type: application/json;charset=utf-8" -d @body.json -X POST https://api.smartrecruiters.com/v1/assessments/511a3942300469a9c33819d1/reject

body.json:

1
2
3
4
5
6
7
8
9
{
    "message": "Candidate is not responding to emails and is not answering the calls. We can't reach him, and unfortunately we need to reject this order",
    "author": {
        "firstName": "John",
        "lastName": "Mnemonic",
        "email": "john.mnemonic@smartrecruiters.com",
        "phone": "(123) 321 32 1231"
    }
}

On rejecting the request, the status of the assessment order changes to REJECTED.

Assessment order statuses

The 4 possible assessment order statuses are,

  • NEW – assessment order takes the NEW status immediately after creation
  • IN_PROGRESS – status changes to IN_PROGRESS once you accept the order
  • REJECTED – status changes to REJECTED on rejecting the order
  • COMPLETED – status changes to COMPLETED after sending complete request