Personio ATS MCP Server

This API is used to reject an application for a job. It requires the application ID, job ID, candidate ID, rejection ID, and a note as input. The rejection ID should be obtained from the List Rejection Reasons API. The response indicates whether the operation was successful or not. If not successful, an error message is provided.

This API endpoint retrieves a list of global tags from various Applicant Tracking Systems (ATS) such as Greenhouse, Lever, Workday, SAP SuccessFactors, Ashby, Zoho Recruit, JazzHR ATS, and Recruitee. The request requires an 'accept' header specifying 'application/json'. The response includes a success flag and a data object containing an array of tags, each with an 'id' and 'text'. If the request fails, an error object with a message is returned.

This API endpoint allows adding a tag to a candidate in an ATS (Applicant Tracking System). The request requires the candidate ID, tag text, tag ID, application ID, and job ID. Tags can be added at the application level or candidate level depending on the ATS system. If the tag ID is not available, a dummy ID can be used. The response indicates whether the operation was successful or not.

This API retrieves a list of rejection reasons from various Applicant Tracking Systems (ATS) such as Greenhouse, Lever, SmartRecruiters, TeamTailor, Breezy, Ashby, Zoho Recruit, Recruitee, and Oracle Taleo. The request requires an 'accept' header specifying 'application/json'. The response includes a success flag and an array of rejection reasons, each with a unique 'id' and 'text' description. In case of an error, an error message is provided.

The Get Candidate Tags API retrieves tags associated with a candidate for a specific application and job. It requires three query parameters: candidateId, applicationId, and jobId, all of which are mandatory. The response includes a success flag and a data object containing an array of tags, each with an id and text. If the request fails, an error message is provided.

This API endpoint allows the creation of a note for a candidate. The note may be tied to an application or exist as a global note depending on the ATS (Applicant Tracking System) behavior. The request requires headers specifying 'accept' and 'content-type' as 'application/json'. The request body must include 'candidateId', 'applicationId', and 'note'. The response will indicate success or provide an error message if the operation fails. Supported ATS include Greenhouse, Lever, SAP SuccessFactors, Workable, TeamTailor, Bullhorn, Ashby, SmartRecruiters, Breezy, Zoho Recruit, BambooHR ATS, JazzHR ATS, Recruitee, Oracle Taleo, and Pinpoint.

The Update Application Stage API allows users to update the stage of an application for a candidate in various supported applications such as Greenhouse, Lever, Oracle Cloud HCM, and others. The API requires a POST request with headers specifying 'accept' and 'content-type' as 'application/json'. The request body must include 'applicationId', 'toStageId', 'currentStageId', 'candidateId', and 'jobId' as required fields, with an optional 'subStageId'. The response will indicate success or provide an error message and type if unsuccessful.

This API endpoint allows the creation of an application in an ATS (Applicant Tracking System). The request can either include a candidateId for an existing candidate or a candidate object with details such as firstName, lastName, emails, and phones. The jobId and initialStageId are required fields. The response includes the success status and the IDs of the created application, job, and candidate. If the request fails, an error message is provided.

This API endpoint allows users to add an attachment to an ATS application. The request requires headers specifying the content type and accept type as 'application/json'. The body of the request must include the applicationId, jobId, candidateId, fileName, and fileType. Optional fields include fileContent, fileUrl, and contentType. The response will indicate success and provide the ID and download URL of the uploaded attachment if successful. If unsuccessful, an error message and type will be provided.