Comeet enables recruiters to automate their recruiting processes by creating workflows comprised of recruiting steps or tasks. These steps are either handled in-house or by external recruiters or integrated recruiting tools. This article is intended for providers of recruiting tools that assess or evaluate candidates.
The API works in the form of webhooks where Comeet performs HTTP requests to the evaluation provider's service. Implementing the API requires the creation of these endpoints:
- Get list of tests
- Submit candidate for evaluation
- Get evaluation
All API calls use
HTTPS and should be verified by your system:
To verify a request you need these values:
secret- received when approved as a Comeet partner. See Getting Access - Become a Partner.
api-key- received from a Comeet customer when the integration is activated.
Comeet will add the
Authorizationheader to all HTTP requests using the following syntax:
Authorization: Bearer <token>
Verify the request by decoding the
secretusing JWT. The result must be identical to the
api-key. You can use one of the many JWT libraries available online.
Set up the integration
- A Comeet user with an Admin role will find your service on Comeet's Integrations page and click Integrate.
- The user will click on Copy Key and will manually input the API Key in your app (ie. by pasting it in your app or sending it to a support rep).
Set up the test step on the position workflow
The recruiter will add a step to the workflow and define it as a step that uses your app. Then the user will select one of the tests that your app provides.
When a candidate reaches the test step, Comeet will initiate the request to submit the test for evaluation.
Test is completed
Comeet periodically checks for the test status until it is completed. After completion, the evaluation is added to the candidate profile. Depending on the
outcomeand the policy defined for the Evaluation app, the candidate will progress in the workflow.
To identify which candidate data to delete, use the GET deleted-candidates endpoint. Note that for evaluation integration, the proper endpoint to use in this case will be: https://api.comeet.co/evaluation/deleted-candidates.