Bitrix24Install

Overview

This node integrates with Bitrix24, a CRM and business platform, to perform various operations on its resources. Specifically, the "Lists" resource with the "Add Field" operation allows users to add custom fields to a specified list within Bitrix24. This is useful for extending the data structure of lists to capture additional information tailored to specific business needs.

Common scenarios include:

• Adding new metadata fields to track custom attributes in project or task lists.
• Extending contact or deal lists with extra details not available by default.
• Dynamically modifying list schemas as business requirements evolve.

For example, a user might add a "Priority" field to a task list to better categorize tasks or add a "Customer Feedback" field to a product list.

Properties

Output

The node outputs an array of items corresponding to the result of the add field operation. Each item contains a json object representing the response from Bitrix24 after attempting to add the field(s). This typically includes confirmation of the added field(s) or error details if the operation failed.

If the operation fails and "Continue On Fail" is enabled, the output will contain an error message along with the resource name and a timestamp.

No binary data output is indicated.

Dependencies

• Requires valid authentication with Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
• The node relies on Bitrix24's API endpoints to manage lists and fields.
• No additional external services are required beyond Bitrix24 itself.
• Proper credentials must be configured in n8n for the chosen authentication method.

Troubleshooting

• Authentication errors: Ensure that the selected authentication method is correctly configured and that tokens or keys are valid and have sufficient permissions.
• Invalid List ID: Verify that the provided List ID exists in Bitrix24 and that the authenticated user has access rights.
• Field configuration issues: Make sure the field names and values conform to Bitrix24's expected formats and constraints.
• API rate limits or connectivity problems: Check network connectivity and Bitrix24 API usage limits.
• Error messages in output: If the node returns an error in the output JSON, review the error message for clues and adjust parameters accordingly.
• Enabling "Continue On Fail" can help process multiple items even if some fail, allowing partial success.

Links and References

• Bitrix24 Official API Documentation
• Bitrix24 Lists API Reference
• n8n Documentation on Credentials and Authentication