Bitrix24

Overview

This node integrates with the Bitrix24 CRM and business platform, allowing users to interact with various Bitrix24 resources. Specifically, for the Activity resource with the Get Fields operation, it retrieves metadata about the fields available in Bitrix24 activities. This is useful when you want to dynamically fetch field information to configure other operations or to understand what data can be accessed or manipulated within Bitrix24 activities.

Common scenarios include:

• Dynamically populating dropdowns or UI elements with available activity fields.
• Preparing data mappings by understanding field types and requirements.
• Automating workflows that depend on specific activity fields without hardcoding field names.

Example: A user wants to list all possible fields of an activity entity in Bitrix24 to build a custom report or to map incoming data correctly before creating or updating activities.

Properties

Output

The node outputs an array of objects representing the fields of the selected Bitrix24 resource (in this case, Activity). Each object typically contains:

• name: The display name of the field (e.g., "Subject", "Start Date").
• value: The internal field identifier used in Bitrix24 API calls.
• description: Additional details about the field such as type, whether it is required, or other metadata.

If an error occurs during fetching, the output will contain an object with an error message describing the failure, along with the resource name and a timestamp.

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 API endpoints to fetch field metadata.
• Relies on internal helper functions to make standardized API calls to Bitrix24.

Troubleshooting

• Common issues:

  • Incorrect or expired authentication credentials leading to authorization errors.
  • Network connectivity problems preventing API calls.
  • Bitrix24 API changes or downtime causing unexpected failures.

• Error messages:

  • "Failed to load CRM fields: <message>": Indicates an issue retrieving fields from Bitrix24. Check authentication and API availability.
  • "Error loading fields" or similar messages in dropdowns: Usually means the API call failed or returned no results.

• Resolutions:

  • Verify that the chosen authentication method is correctly configured and active.
  • Ensure the Bitrix24 account has permissions to access the requested resource.
  • Retry after some time if the issue is due to temporary API unavailability.

Links and References

• Bitrix24 Official API Documentation
• Bitrix24 CRM Fields Reference
• n8n documentation on creating custom nodes