Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

This node integrates with the Bitrix24 platform, specifically allowing users to add a new section to an entity within Bitrix24's data storage system. It is useful for extending CRM entities by organizing fields into logical sections, improving data management and user interface clarity.

Typical use cases include:

  • Customizing CRM entities by adding new sections to group related fields.
  • Automating the creation of entity sections during onboarding or integration workflows.
  • Structuring data input forms in Bitrix24 to match business processes.

For example, a sales team might add a "Customer Preferences" section to contact entities to capture additional information relevant to their sales process.

Properties

Name Meaning
Authentication Method to authenticate with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key.
Section Name The display name of the new entity section to be added.
Section Code A unique code identifier for the entity section.
Section Active Boolean flag indicating whether the section is active (true) or inactive (false).
Section Sort Order Numeric value defining the order in which the section appears relative to others (default 100).
Section Description Text description providing details about the purpose or content of the section.

Output

The node outputs JSON data representing the result of the operation. This typically includes confirmation of the newly created section or error details if the operation fails.

The output structure contains at least:

  • json: An object with the response from Bitrix24 regarding the added section.
  • In case of failure and if "Continue On Fail" is enabled, the output will contain an error message, the resource involved, 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.
  • The node depends on Bitrix24's API endpoints to create and manage entity sections.
  • Proper configuration of credentials in n8n is necessary to enable communication with Bitrix24.

Troubleshooting

  • Common Issues:

    • Authentication failures due to incorrect or expired credentials.
    • Insufficient permissions in Bitrix24 to modify entity structures.
    • Invalid or duplicate section codes causing API errors.
  • Error Messages:

    • Errors returned from Bitrix24 API will be included in the output JSON under the error field if "Continue On Fail" is enabled.
    • Typical messages may indicate authorization problems, validation errors on input fields, or connectivity issues.
  • Resolutions:

    • Verify that the selected authentication method is correctly configured and authorized.
    • Ensure the section code is unique and follows any naming conventions required by Bitrix24.
    • Check network connectivity and API endpoint availability.
    • Enable "Continue On Fail" to handle errors gracefully in workflows.

Links and References

Discussion