Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, specifically allowing users to add a new property to an entity item within Bitrix24's data storage system. It is useful for extending CRM entities or other business objects by defining custom properties that can hold additional information.

Typical use cases include:

• Adding custom fields to CRM entities like contacts, deals, or leads to capture extra data relevant to your business processes.
• Defining list-type properties with predefined values to standardize input.
• Configuring properties with specific types (e.g., string, number, date) and behaviors (required, multiple values allowed).

For example, you might add a "Customer Priority" property of type List with values "High, Medium, Low" to a contact entity to help segment customers.

Properties

Output

The node outputs JSON data representing the result of the operation performed on Bitrix24. This typically includes confirmation of the property addition or details about any errors encountered.

If the operation fails but the node is configured to continue on failure, the output JSON will contain an error field with the error message, along with metadata such as the resource name and 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).
• Relies on Bitrix24 API endpoints to perform operations; thus, network connectivity and proper API permissions are necessary.
• No additional external services beyond Bitrix24 are required.

Troubleshooting

• Common Issues:

  • Incorrect or expired authentication credentials leading to authorization failures.
  • Invalid property codes or names causing API rejections.
  • Attempting to add properties with unsupported types or malformed property values.
  • Network issues preventing communication with Bitrix24 API.

• 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 invalid parameters, permission denied, or rate limiting.

• Resolutions:

  • Verify and refresh authentication credentials.
  • Ensure property codes conform to Bitrix24 naming rules.
  • Validate property values especially for list types (comma-separated strings).
  • Check network connectivity and API access rights.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 CRM Custom Fields Guide
• n8n Documentation on Creating Custom Nodes