Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

The "Get User" operation of the Bitrix24 node retrieves detailed information about a specific user from the Bitrix24 platform. This node is useful in scenarios where you need to fetch user data for CRM automation, reporting, or integration workflows. For example, you might use it to get user details before assigning tasks, sending notifications, or synchronizing user profiles with other systems.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key.
User ID The unique identifier of the user to retrieve.
Options Additional optional parameters:
- Filter JSON object specifying filter criteria to narrow down the user query.
- Order JSON object specifying sorting order of the results.
- Admin Mode Boolean flag indicating whether to perform the request in admin mode.
- Custom Parameters JSON object for any extra custom parameters to include in the API call.

Output

The node outputs an array of items, each containing a json property with the user data retrieved from Bitrix24. The structure of the json output corresponds to the user fields returned by the Bitrix24 API, including standard user attributes such as ID, name, email, and any additional custom fields.

If an error occurs and the node is configured to continue on failure, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.

This node does not output binary data.

Dependencies

  • Requires authentication credentials for Bitrix24 via one of the supported methods: OAuth2, webhook URL, or API key.
  • Needs proper configuration of these credentials within n8n to successfully connect to the Bitrix24 API.
  • Relies on Bitrix24's REST API endpoints to fetch user data.

Troubleshooting

  • Common Issues:

    • Invalid or expired authentication credentials can cause authorization failures.
    • Providing an incorrect or non-existent User ID will result in no data or errors.
    • Malformed JSON in filter, order, or custom parameters may cause API request errors.
    • Insufficient permissions when not using admin mode might restrict access to certain user data.

  • Error Messages:

    • Errors returned from the Bitrix24 API are surfaced in the node output if "Continue On Fail" is enabled.
    • Typical messages include authentication failures, invalid parameters, or resource not found.

  • Resolutions:

    • Verify and refresh authentication credentials.
    • Double-check the User ID and ensure it exists in Bitrix24.
    • Validate JSON syntax in optional parameters.
    • Use admin mode if elevated permissions are required.

Links and References

Discussion