Overview
The recruitment process is the entry point for new data into the Worky system. You can create job vacancies, publish them, and track applicants. When an applicant is hired, their data seamlessly transitions to the Onboarding flow.
1. Create a Vacancy
Define the job position, requirements, and hiring team.
POST
/api/v1/accounts/directory/vacanciesRequest Body
{
"title": "Senior Software Engineer",
"departmentId": "dept-123",
"jobPositionId": "jp-456",
"salaryRange": {
"min": 50000,
"max": 70000,
"currency": "MXN"
},
"status": "OPEN",
"isPublic": true
}2. List Applications
Retrieve applications for your open vacancies to review candidates.
GET
/api/v1/accounts/directory/vacancy-applicationsResponse
{
"content": [
{
"id": "app-789",
"candidateName": "Ana Silva",
"email": "[email protected]",
"vacancyId": "vac-001",
"status": "INTERVIEW_PHASE",
"appliedDate": "2024-03-10"
}
]
}3. Move to Hired
Once a candidate accepts an offer, update their status to HIRED. This triggers the pre-onboarding checks.
PUT
/api/v1/accounts/directory/vacancy-applications/{id}/statusNext Step: After hiring, proceed to the Onboarding Guide to invite them to the platform.
