Bitrix24Install

Overview

The node integrates with the Bitrix24 CRM and business platform, allowing users to interact with various Bitrix24 resources such as contacts, deals, leads, companies, quotes, invoices, products, and activities. Specifically, for the Product resource and the Get Product Properties operation, the node fetches metadata about product fields available in the Bitrix24 CRM.

This is useful when you want to dynamically retrieve the list of product properties (fields) that can be used in other operations, such as creating or updating products, or for building dynamic UI elements based on available product data.

Practical examples:

• Automatically loading all available product fields to map data from an external system.
• Displaying product field options in a dropdown for user selection in subsequent workflow steps.
• Validating input data against the actual product fields defined in Bitrix24.

Properties

Output

The node outputs JSON data representing the result of the requested operation on the selected resource. For the "Get Product Properties" operation, the output JSON contains an array of product field definitions, each including:

• Field ID (internal identifier)
• Field display name (label)
• Field type
• Whether the field is required
• Additional descriptive information

If an error occurs during the API call, the output JSON will contain an error property with the error message, the resource name, and a timestamp.

The node does not output binary data.

Dependencies

• Requires connection to a Bitrix24 instance via one of the supported authentication methods:

  • OAuth2 authentication token
  • Webhook URL
  • API key credential

• The node uses Bitrix24's REST API endpoints to fetch CRM entity fields.

• No additional external dependencies beyond standard n8n credentials and HTTP request capabilities.

Troubleshooting

• Common issues:

  • Incorrect or expired authentication credentials leading to authorization errors.
  • Network connectivity problems preventing API calls.
  • Bitrix24 API rate limits or temporary unavailability.
  • Selecting an unsupported or misspelled resource or operation.

• Error messages:

  • "Failed to load CRM fields: <message>": Indicates failure to retrieve fields from Bitrix24. Check API credentials and network access.
  • Generic API errors returned by Bitrix24 will be included in the error field of the output JSON.

• Resolution tips:

  • Verify that the authentication method is correctly configured and valid.
  • Ensure the Bitrix24 account has sufficient permissions to access CRM product fields.
  • Retry after some time if encountering rate limits or transient API errors.
  • Use the "continue on fail" option in the node settings to handle errors gracefully in workflows.

Links and References

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