Bitrix24

Interact with Bitrix24 CRM and business platform

Actions89

Overview

The node integrates with the Bitrix24 platform, specifically focusing on the "Data Storage" resource and the "Get Types" operation. It retrieves various types of data entities or metadata from Bitrix24, such as CRM entity types or Smart Process Automation (SPA) types. This is useful for workflows that need to dynamically fetch and work with different entity types available in a Bitrix24 account.

Common scenarios include:

Fetching available CRM entity types to populate dropdowns or validate input.
Retrieving SPA types for automation processes.
Dynamically loading entity metadata to drive further API calls or data processing.

For example, a user might use this node to get all CRM deal categories or SPA types before creating or updating records in those categories.

Properties

Name	Meaning
Authentication	Method to authenticate with Bitrix24: OAuth2 (recommended), Webhook (simpler but less secure), or API Key
Options	Additional parameters for filtering and pagination (only shown for some resources):
- Access Token	String token used for authentication (if applicable)
- Filter	JSON object specifying filter criteria for the query
- Select	Comma-separated list of fields to select
- Order	JSON object defining order criteria
- Start	Number indicating the start position for pagination

Note: The "Options" property is conditionally displayed based on the selected resource and operation.

Output

The node outputs an array of items where each item contains a json object representing the retrieved types or metadata from Bitrix24. The structure typically includes:

name: Display name of the type or category
value: Identifier or key for the type
description: Additional descriptive information about the type

If an error occurs during execution, the output will contain an error object with:

error: Error message string
resource: The resource name involved in the call
timestamp: ISO timestamp of when the error occurred

No binary data output is produced by this node.

Dependencies

Requires valid authentication credentials for Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
Uses Bitrix24 REST API endpoints internally to fetch data.
No additional external services are required beyond Bitrix24 itself.
Proper configuration of authentication credentials in n8n is necessary.

Troubleshooting

Common issues:
- Invalid or expired authentication tokens leading to authorization errors.
- Incorrect filter or option formats causing API request failures.
- Network connectivity problems preventing access to Bitrix24 API.
Error messages:
- Errors returned from Bitrix24 API calls will be surfaced with their message in the output's error field.
- If the node fails to load types, it may return placeholder options indicating no data or an error description.
Resolutions:
- Verify and refresh authentication credentials.
- Ensure JSON filters and orders are correctly formatted.
- Check network access and Bitrix24 service status.