Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

The node integrates with the Bitrix24 platform, specifically allowing interaction with its CRM and business data. The "Add Entity Item" operation under the "Data Storage" resource enables users to add a new item (record) to a specified entity within Bitrix24. This is useful for automating the creation of CRM records such as contacts, deals, leads, or custom entities.

Typical use cases include:

  • Automatically adding new customer records when a form is submitted.
  • Creating new deal entries based on external triggers.
  • Adding items to custom entities in Bitrix24 for workflow automation.

Properties

Name Meaning
Authentication Method to authenticate with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key.
Entity ID The identifier of the entity where the item will be added.
Item Name The name/title of the new entity item being created.
Item Active Boolean flag indicating if the item should be marked as active.
Item Sort Order Numeric value defining the sort order priority of the item.
Item Description Text description providing additional details about the item.
Item Properties A collection of additional properties for the entity item, provided as JSON key-value pairs.

Output

The node outputs an array of JSON objects representing the result of the add operation. Each output item contains the response from Bitrix24 confirming the creation of the entity item, including any IDs or metadata returned by the API.

If binary data were involved (not indicated here), it would typically represent files or attachments related to the entity item, but this operation focuses on JSON data only.

Dependencies

  • Requires connection to Bitrix24 via one of the supported authentication methods: OAuth2, webhook URL, or API key.
  • Needs proper configuration of credentials in n8n corresponding to the chosen authentication method.
  • Relies on Bitrix24 API endpoints to perform entity item creation.

Troubleshooting

  • Authentication errors: Ensure that the selected authentication method is correctly configured with valid credentials or tokens.
  • Invalid Entity ID: Verify that the Entity ID corresponds to an existing entity in Bitrix24; otherwise, the API call will fail.
  • Malformed JSON in Item Properties: The itemProperties field expects valid JSON; invalid JSON syntax will cause errors.
  • API rate limits or connectivity issues: Network problems or Bitrix24 API limits may cause failures; check connectivity and retry policies.
  • Error messages: If the node throws errors, they usually contain the Bitrix24 API error message. Review these messages to adjust parameters or credentials accordingly.

Links and References


This summary is based on static analysis of the node's source code and provided property definitions, focusing on the "Add Entity Item" operation under the "Data Storage" resource.

Discussion