Employees: Overview of Methods

Employees in Bitrix24 are users of the company who work with tasks, internal communications, CRM, and other tools. Within the company structure, employees are distributed across departments and teams and can be leaders, deputies, or regular participants.

The methods humanresources.employee.* return data from the employee's digital profile: user ID, name, position, avatar, profile link, departments, and teams. These methods can be used to find employees by name, get the total number of employees, check the user's subordinates, and find employees who belong to multiple departments.

Quick navigation: all methods

User documentation: Work with the employee list in Bitrix24

How to Get StartedHow to Get Started

1. Find an employee using the humanresources.employee.search method if part of the name is known.
2. Obtain the userId from the search response or using the user.get method.
3. Get the field descriptions using the humanresources.employee.field.list and humanresources.employee.field.get methods if you need to understand in advance what employee data can be retrieved.
4. Check the user's subordinates using the humanresources.employee.subordinates method if you need to assess the composition of departments where the user is a leader or deputy.
5. Get the total number of employees using the humanresources.employee.count method.
6. Find employees in multiple departments using the humanresources.employee.multidepartment method if you need to check for dual employment.

Section LimitationsSection Limitations

• The methods in this section are available to authorized users linked to a department in the company structure.

Connection with Other ObjectsConnection with Other Objects

Users. The userId field corresponds to the Bitrix24 user ID. It can be obtained using the user.get method or from the response of humanresources.employee.search.

Departments and Teams. The responses from the methods return data about the employee's connection with departments and teams. Details about a department or team can be obtained using the humanresources.node.get method.

Participants of Departments and Teams. If you need to change the composition of a department or team after finding an employee, use the methods humanresources.node.member.add, humanresources.node.member.move, and humanresources.node.member.remove.

Overview of MethodsOverview of Methods

Scope: humanresources

Who can perform the method: depends on the method

Method	Description
humanresources.employee.search	Searches for employees by name
humanresources.employee.subordinates	Returns the user's subordinates by departments
humanresources.employee.count	Returns the number of employees in the company structure
humanresources.employee.multidepartment	Returns employees who belong to multiple departments
humanresources.employee.field.list	Returns a list of employee fields
humanresources.employee.field.get	Returns the description of an employee field

Continue ExploringContinue Exploring

• Departments and Teams: Overview of Methods
• Participants of Departments and Teams: Overview of Methods
• Company Structure in REST 3.0: Overview of Sections