The response to https://api.smartrecruiters.com/feed/publications/{postingId} now contains customFields. This allows users to retrieve custom fields associated with a posting.
This enhancement is backward-compatible and does not require any changes to existing client implementations.
New property noPolicyDescription was added to settings.consentSettings object in the response of the Get application configuration for posting endpoint.
This property is a disclaimer that should be used to notify candidates that their personal data is bound by your company's privacy policy. It's returned when company privacy policy has not been defined.
This enhancement is backward-compatible and does not require any changes to existing client implementations.
Introducing the new public API - Candidate Status API. This API allows to retrieve candidates application status from the candidate perspective.
Possible statuses are: NEW, IN_REVIEW, INTERVIEW, OFFERED, HIRED, ARCHIVED.
For ARCHIVED there is also substatus returned: REJECTED, WITHDRAWN_BY_APPLICANT, TRANSFERRED, DELETED_BY_COMPANY.
To use this API, you must be granted the candidate_view_application_status_read access scope.
There are neither breaking changes in the existing API nor any migration steps required.
Added optional name and description parameters to the POST /webhooks-api/v201907/subscriptions endpoint request and response.
Both fields are validated:
name should have maximum length of 100 characters, and contain only alphanumeric characters and spaces,description should have maximum length of 500 characters, and cannot contain ;\<> characters.If present, name and description parameters will be added to responses for endpoints:
GET /webhooks-api/v201907/subscriptionsGET /webhooks-api/v201907/subscriptions/{subscriptionId}This enhancement is backward-compatible and does not require any changes to existing client implementations.
Extending Configuration API by adding endpoints allowing to manage Predefined Locations:
GET configuration/predefined-locations - Get many predefined locationsGET configuration/predefined-locations/{id} - Get one predefined locationPOST configuration/predefined-locations - Create a predefined locationPUT configuration/predefined-locations/{id} - Update a predefined locationDELETE configuration/predefined-locations - Delete many predefined locationDELETE configuration/predefined-locations/{id} - Delete a predefined locationThis enhancement is backward-compatible and does not require any changes to existing client implementations.
Extending Configuration API by adding key parameter in response to endpoints:
GET configuration/job-propertiesPOST configuration/job-propertiesGET configuration/job-properties/idPATCH configuration/job-properties/idThis enhancement is backward-compatible and does not require any changes to existing client implementations.
Extending Configuration API by adding the following endpoints to read career site configuration:
GET /configuration/career-sites: Lists career sites configurations using pagination.GET /configuration/career-sites/{careerSiteId}: Get details of a single career site configuration by id.To use these endpoints, you need to be granted the configuration_read access scope.
This enhancement is backward-compatible and does not require any changes to existing client implementations.
Extending Self Scheduling API by adding endpoints to:
To use this API, you will need the following access scopes: self_schedules_read or self_schedules_manage.
The Self Schedule API allows to create, delete and search for interview self schedules, providing similar functionality as the UI. Self scheduling allows candidate to pick up the time slot for the interview, and interview would be created as a result.
Assessment API(v1) endpoints, that were officially sunset on June 10th 2024, are removed. This API was replaced by the Assessment API(2021). Removed endpoints:
GET https://api.smartrecruiters.com/v1/assessmentsPOST https://api.smartrecruiters.com/v1/assessmentsPOST https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/rejectPOST https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/completePOST https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/acceptGET https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}GET https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/commentsPOST https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/commentsGET https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/comments/{commentId}Related Offers API(v1) endpoints are also removed:
POST https://api.smartrecruiters.com/v1/offersGET https://api.smartrecruiters.com/v1/offers/{offerId}POST https://api.smartrecruiters.com/v1/offers/{offerId}POST https://api.smartrecruiters.com/v1/offers/{offerId}/withdrawPOST https://api.smartrecruiters.com/v1/offers/{offerId}/submitwith the exception of GET https://api.smartrecruiters.com/v1/offers, which is not removed.
This change is not backward-compatible. All customers using the Assessment API(v1) and Offers API (v1) no longer have access to these APIs. All integrations still using these APIs are affected.