Bitrix24 icon

Bitrix24

Работа с Bitrix24 API

Overview

This node integrates with the Bitrix24 CRM system to manage company records via its API. Specifically, for the Company - List operation, it retrieves a list of company records from Bitrix24. It supports fetching all records or limiting the number of returned entries and allows selecting specific fields to optimize data retrieval.

Common scenarios where this node is beneficial include:

  • Synchronizing company data from Bitrix24 into other systems.
  • Generating reports or dashboards based on company information.
  • Filtering and retrieving only relevant company details for further processing in workflows.

For example, you can use this node to fetch all companies with selected fields like "Company Name" and "Industry" to feed into a marketing automation tool.

Properties

Name Meaning
Return All Whether to retrieve all company records (true) or limit the number of records (false).
Limit Maximum number of company records to return when Return All is false.
Select Fields Specific company fields to retrieve. You can select multiple fields to customize output.

Output

The node outputs an array of JSON objects representing company records retrieved from Bitrix24. Each object contains key-value pairs corresponding to the selected fields of a company.

  • If no fields are selected, the output includes all available fields by default.
  • When Return All is enabled, all matching company records are returned.
  • When limited, only up to the specified number of records are included.

The node does not output binary data; all data is structured as JSON.

Dependencies

  • Requires a valid Bitrix24 API authentication token configured in the node credentials.
  • The node uses the Bitrix24 webhook URL to make API requests.
  • Network access to the Bitrix24 API endpoint is necessary.

Troubleshooting

  • No credentials got returned!
    This error indicates missing or invalid API credentials. Ensure that the Bitrix24 API authentication token is correctly set up in the node credentials.

  • Webhook URL is required!
    The node requires a valid Bitrix24 webhook URL to function. Verify that the webhook URL is provided and correctly configured.

  • Invalid response from Bitrix24!
    This may occur if the API endpoint is unreachable or returns unexpected data. Check network connectivity and verify the webhook URL.

  • Failed to load fields: ...
    Happens when dynamically loading selectable fields fails. Confirm that the API credentials and webhook URL are correct and that the Bitrix24 API is accessible.

  • API request errors (e.g., rate limits, permission issues)
    These errors will be returned from the Bitrix24 API. Review API permissions and usage limits.

Links and References

Discussion