Change Log

December 16th, 2021

Assessment
A new endpoint RetrieveAssessmentResult is now available for users to retrieve assessment results of an application.

Users can retrieve assessment results of a job application using the endpoint by providing application_id. If you are using OAuth 2.0 to authenticate for the request, the access scope assessment_order_read must be included.

Webhook
We have added 3 additional webhook events that users will be able to subscribe to:

  • review.created - Event callback will trigger when a review of an application is created.
  • review.updated - Event callback will trigger when a review of an application is updated.
  • review.deleted - Event callback will trigger when a review of an application is deleted.

December 9th, 2021

Webhook
application_id, the unique identifier of a candidate job application, is now returned as an additional field in the payload of application callback events.

Specifically, the following webhook callback events now include the field application_id:

  • application.created
  • application.status.updated
  • application.source.updated
  • application.fields.updated
  • application.screening-answers.updated
  • application.onboarding-status.updated
  • application.attachment.created

November 18th, 2021

Application
The valueLabel property is added into the response payload of the [ListApplicationProperty] (ref:candidatespropertiesgetforjob-1) endpoint. This change can helps reduce the number of calls require to retrieve the candidate property values of an application.

For backward compatibility consideration, the same valueLabel property is also added on to the [same legacy] (ref:https://developers.smartrecruiters.com/reference/candidatespropertiesget-1) endpoint

November 11th, 2021

Application
The applicationId property, the unique application identifier, is now returned in the RetrieveApplication endpoint.

October 14th, 2021

Posting
A new query parameter releaseAfter is introduced on the ListPostings endpoint which users can use to filter list of postings by the job posting's releaseDate.

October 7th, 2021

Webhook
We have added 2 additional webhook events that webhook users will be able to subscribe to:

  • job.approval.comment.created - Event callback will trigger when a comment of a job approval request is created.
  • offer.approval.comment.created - Event callback will trigger when a comment of an offer approval request is created.

September 30th, 20201

Webhook
We have added 2 additional webhook events that webhook users will be able to subscribe to:

  • job.approval.abandoned- Event callback will trigger when a job approval request is abandoned.
  • offer.approval.abandoned - Event callback will trigger when an offer approval request is abandoned.

September 23rd, 2021

Webhook
Webhook custom authentication header now supports OAuth 2.0 Client Credential.

Webhook users who are looking for additional authentication when SmartRecruiters call the callbackUrl can specify clientId, clientSecret and TokenServiceUrl when creating the webhook subscription. If configured, SmartRecruiters will pass the access token exchanged from the TokenServiceUrl in the custom header of the callback.

September 16th, 2021

Webhook
We have added 4 additional webhook events that webhook users will be able to subscribe to:

  • job.approval.step.approved - Event callback will trigger when the approver of the step of the approval process approved the job.
  • offer.approval.step.approved - Event callback will trigger when the approver of the step of the approval process approved the offer.
  • job.approval.step.rejected - Event callback will trigger when the approver of the step of the approval process rejected the job.
  • offer.approval.step.rejected - Event callback will trigger when the approver of the step of the approval process rejected the offer.

Posting
The property jobAdId is added into the response payload for the [RetrievePosting] (ref:v1getposting-1) endpoint.

September 9th, 2021

Webhook
We have added 4 additional webhook events that webhook users will be able to subscribe to:

  • job.approval.step.approved - Event callback will trigger when the approver of the step of the job approval process approved the job.
  • offer.approver.step.approved - Event callback will trigger when the approver of the step of the offer approval process approved the offer.
  • job.approval.step.rejected - Event callback will trigger when the approver of the step of the job approval process rejected the job.
  • offer.approver.step.rejected - Event callback will trigger when the approver of the step of the offer approval process rejected the offer.

August 16th 2021

Webhook
We have added 4 additional webhook events that webhook users will be able to subscribe to:

  • job.approver.skipped - Event callback will trigger when an approver of a job approval request is skipped
  • offer.approver.skipped - Event callback will trigger when an approver of an offer approval request is skipped.
  • job.approver.delegated - Event callback will trigger when a delegated approver is assigned by the original approver to substitute the original approver to approve the job for a selected period of time.
  • offer.approver.delegated - Event callback will trigger when a delegated approver is assigned by the original approver to substitute the original approver to approve the offer for a selected period of time.

July 15th 2021

Pagination
Cursor-based pagination is now available on both ListCandidates and ListJobs. We introduce the change because cursor-based pagination can help reduce latency in performance when users interact with more stability and reliability to SmartAPIs and SmartRecruiters systems

With an introduction of cursor-based pagination the offset-based pagination for these two endpoints will begin to sunset and will not be supported after the May 2022.

To ensure your application will continue to work after May 2022 and to take advantage on the improved performance cursor-based pagination has to offered, we recommend adjusting and updating your applications and integrations to the cursor-based pagination approach as soon as possible.