Users: Overview of Methods

The user profile is a key object in Bitrix24. Without a user profile, an employee cannot use the corporate account and CRM. The user ID can be used to:

• configure access permissions,
• assign tasks among employees,
• obtain information about employee actions.

Quick navigation: all methods

User documentation: How to invite employees to Bitrix24

How to Work with UsersHow to Work with Users

Use the method:

• user.add to invite new users. The username must not exceed 25 characters.
• user.update to edit the profiles of existing users, terminate or reinstate an employee.

Connection with Other ObjectsConnection with Other Objects

CRM. The user ID is used in system fields:

• editable: responsible person, observers,
• read-only: who created, who modified, who moved to the stage.

Use the crm.item.* methods to read or modify fields.

Calendar. To work with an employee's calendar, specify the user ID in the ownerID field in the calendar.section.* methods. To create or modify a meeting with multiple participants, specify the user IDs in the host and attendees fields in the calendar.event.* methods.

News Feed. Use user IDs in the methods:

• log.blogpost.* to address a post to specific employees,
• log.blogpost.getusers.important to check who among employees has read an important post.

Online Store. The user ID is used in system fields:

• editable: responsible for the order, shipment, payment,
• read-only: who changed the status, who marked, who canceled, who processed a return.

Use the sale.order.*, sale.payment.*, sale.shipment.* methods to read or modify fields.

Chats. Use user IDs in the methods im.chat.*, im.chat.user.*, im.user.* to assign a chat owner, edit the list of participants, or obtain information about chat participants.

Open Channels. Use user IDs:

• to configure the queue of responsible employees in the imopenlines.config.* methods,
• to assign dialogues to employees in the imopenlines.bot.session.*, imopenlines.crm.chat.user.*, imopenlines.operator.* methods.

Telephony. Use the user ID:

• to direct a phone call to them in the telephony.externalcall.* methods,
• to obtain call statistics for the employee using the voximplant.statistic.get method,
• to configure SIP devices in the voximplant.user.* methods.

Time Tracking. Use user IDs:

• to manage the user's workday in the timeman.* methods,
• to configure the tool for tracking working hours in the timeman.timecontrol.* methods,
• to obtain information about the work schedule using the timeman.schedule.get method.

Tasks. The user ID is used in system fields:

• editable: creator, assignee, participants, observers,
• read-only: who changed the task, who changed the status, who completed the task.

Use the tasks.task.* methods to read or modify fields. To find out or edit the time spent on a task for a user — task.elapseditem.*.

Workgroups and Projects. Use user IDs in the sonet_group.user.* methods to change the composition of group members and their roles. Specify the user ID in the SCRUM_MASTER_ID field to create a Scrum group.

Company Structure. Use user IDs to manage the binding of employees to company departments in the department.* methods.

User Binding TypeUser Binding Type

In Bitrix24, you can create custom fields with the type "user binding." Fields accept a user ID if they are simple and an array of IDs if they are multiple.

• Custom fields are available in the CRM and online store sections.
• Custom properties are available in the universal lists, data storage, and in the product catalog.
• Parameters and variables are available in workflows.

User Access PermissionsUser Access Permissions

Use the user ID to configure access permissions in the methods:

• disk file disk.folder.uploadfile and disk.storage.uploadfile,
• document generator documentgenerator.role.fillaccesses,
• sites landing.site.setRights.

Working with Extranet UsersWorking with Extranet Users

Extranet users are users who have limited access to Bitrix24 functionality. CRM is not available for extranet users, but chats, groups, and calendar are accessible.

To invite an extranet user, use the user.add method with the parameters:

• EXTRANET: Y — mark as an external user,
• SONET_GROUP_ID: [...] — IDs of groups the user will belong to.

When adding an extranet user to a group using the sonet_group.user.add method, the group automatically changes its type to external.

WidgetsWidgets

You can embed an application in the user profile. With embedding, you can use the application without leaving the user card.

• Context menu item in the profile USER_PROFILE_MENU

• Context menu item in the top profile button USER_PROFILE_TOOLBAR

User Data Access LevelsUser Data Access Levels

To ensure the security of employee data, different versions of the User scope are available for applications and webhooks.

• user_brief provides access to user information without contact details. This is sufficient for scenarios where displaying the user's full name in a third-party application interface is required.

• user_basic opens basic information and contact details of users. This is required for scenarios related to making calls or sending e-mails.

• user provides full access to user information, the ability to invite new users, and modify existing data.

Overview of MethodsOverview of Methods

Scope: user

Who can perform the method: depending on the method

Method	Description
user.add	Invites a user
user.update	Updates user data
user.current	Retrieves information about the current user
user.get	Retrieves a filtered list of users
user.search	Retrieves a list of users with accelerated search by personal data
user.fields	Retrieves a list of user profile fields