This blog deals with the topic of updating applicants’ statuses using OData API. One can either use a tool such as Postman or, more easily, Integration Center.
Here we’ll look at how to use Integration Center to achieve this. Though its fairly easy, there are some points one must watch out for in order to successfully use this method.
Why Would One Want to Update Applicant Status via APIs?
There could be several reasons. One customer said they’re comfortable exporting all the 3000 candidates from a particular status and update them to another status via an import. They wanted to import to next status only those candidates that passed an onsite assessment.
Another customer had the partner import legacy applications into the Forwarded status and was therefore unable to see them in the pipeline, though the count showed they were there.
Forwarded and Invite to Apply are inactive statuses – these are not supported for applications. If there is a candidate in one of these statuses, it would mean that the candidate doesn’t yet have a corresponding application. The statuses supported for an application are default, the disposition statuses and other customer-defined statuses.
While experienced consultants would know the relevant statuses for an application, neither the documentation nor the UI provides any warning if an incorrect status is used.
Ideally, an attempt for such an import should result in an error with appropriate messages in the log.
A common request from customers is to automatically move candidates to statuses based on certain conditions. This is currently only possible for a disposition status based on the responses to prescreening questions.
Postman or Integration Center?
If one is familiar with using tools like Postman, then that’s the preferred choice. Though Integration Center is easy to use, there are a number of pitfalls.
So How does One do it?
Create the Outbound Integration
Let’s look at the export first. Your scenario might not need it but its always good to know.
Navigate to Admin Center -> Integration Center -> My Integrations