Skip to main content
Registering an employee does two things at once: it positions the person in the hierarchy (branch × sector × position) and, by default, generates the hiring exam pendency.
Prerequisite: the company structure (Branch, Sector and Position) must already exist, since you provide branch_id, sector_id and position_id.

Sequence

Step by step

1

Build the employee payload

Provide the required fields: name, gov_id (CPF), sex, is_disabled, organization_id, branch_id, sector_id, position_id, admission_date and status. Add any complementary fields you have (contact, hr_code, eSocial data, etc.).
2

Create the employee

POST /v0/employee. The hierarchy is resolved from the three IDs; if the combination does not yet exist in the organization, it is created.
3

Automatic hiring exam

With create_exam = true (default), a pendency of type HIRING is generated. Use send_email/send_date to control the communication to the employee.
4

Track the pendency

List the employee’s pendencies in List pendencies and track the status until completion (ASO).
If the employee is PCD (is_disabled = true), you may need to associate a PCD analysis (disability_analysis_id).

Following events

Dismissal, return and risk change generate new pendencies automatically — see the Exam lifecycle.