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/vacancies
Request 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-applications
Response
{
  "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}/status
Next Step: After hiring, proceed to the Onboarding Guide to invite them to the platform.