Bitrix24Install

Overview

This 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, the "Activity" resource with the "Get Fields" operation enables users to dynamically retrieve metadata about the fields available for activities in Bitrix24.

This is useful when building workflows that need to adapt to the structure of Bitrix24 data dynamically, for example:

• Automatically generating forms or UI elements based on available activity fields.
• Validating or mapping incoming data against the current Bitrix24 activity schema.
• Synchronizing or exporting activity data with external systems by understanding field definitions.

Properties

Output

The node outputs an array of objects representing the fields available for the selected Bitrix24 resource (in this case, Activity). Each object typically contains:

• name: The display label of the field (e.g., "Subject", "Start Date").
• value: The internal field ID used in Bitrix24 API calls.
• description: Additional information about the field, such as its type and whether it is required.

If an error occurs during fetching, the output will contain an object with an error message describing the failure.

The output is structured as JSON data under the json property of each item. This node does not output binary data.

Dependencies

• Requires a valid Bitrix24 authentication credential configured in n8n, which can be one of:

  • OAuth2 token
  • Webhook URL
  • API key

• Uses Bitrix24 REST API endpoints to fetch field metadata.

• No additional external dependencies beyond standard HTTP requests to Bitrix24 API.

Troubleshooting

• Common Issues:

  • Incorrect or expired authentication credentials may cause API call failures.
  • Network connectivity issues can prevent successful communication with Bitrix24.
  • Selecting an unsupported or invalid resource/entity type may result in empty or error responses.

• Error Messages:

  • "Failed to load CRM fields: <error message>" indicates a problem retrieving fields from Bitrix24. Verify authentication and API permissions.
  • "Error loading fields" or similar messages suggest issues in the API response or internal processing errors.

• Resolutions:

  • Ensure the chosen authentication method is correctly set up and authorized.
  • Check network access to Bitrix24 endpoints.
  • Confirm the resource and entity types are valid and supported by your Bitrix24 instance.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 Official Website
• n8n Documentation on Credentials