Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, specifically allowing users to add a new property to a product in the Bitrix24 CRM system. It is useful for extending the product data model by defining custom attributes or metadata that better fit specific business needs.

Typical use cases include:

• Adding custom fields to products to capture additional information such as warranty period, manufacturer details, or special categorizations.
• Automating product catalog updates by programmatically adding properties during import or synchronization workflows.
• Enhancing reporting and filtering capabilities by introducing new product attributes.

For example, a user might add a "Color" property of type "List" with predefined values like "Red, Blue, Green" to classify products by color.

Properties

Output

The node outputs an array of items where each item contains a json object representing the result of the add property operation. This typically includes confirmation details from Bitrix24 about the newly created property.

If an error occurs and the node is configured to continue on failure, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.

No binary data output is produced by this node.

Dependencies

• Requires access to a Bitrix24 account with appropriate permissions to modify product properties.
• Supports three authentication methods: OAuth2, webhook URL, or API key. Proper credentials must be configured in n8n accordingly.
• Relies on Bitrix24's REST API endpoints for CRM product management.

Troubleshooting

• Common issues:

  • Invalid or missing authentication credentials will cause authorization failures.
  • Providing duplicate or invalid property codes may result in API errors.
  • Incorrect property types or malformed property values (especially for list types) can cause request rejections.

• Error messages:

  • Errors returned from Bitrix24 API are surfaced in the node output under the error field if "Continue On Fail" is enabled.
  • Typical error messages include authentication failures, validation errors for property parameters, or network connectivity issues.

• Resolutions:

  • Verify that the selected authentication method is correctly set up and credentials are valid.
  • Ensure property codes are unique and conform to Bitrix24 naming rules.
  • Validate that list-type property values are properly formatted as comma-separated strings.
  • Check network connectivity and Bitrix24 service status if requests fail unexpectedly.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 CRM Product Fields
• n8n Documentation on Credentials