Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, specifically allowing users to add new entities within the "Data Storage" resource. It supports multiple authentication methods including OAuth2, webhook URLs, and API keys, making it flexible for different security requirements.

Typical use cases include automating the creation of custom data entities in Bitrix24 CRM or business processes, such as adding new records for contacts, deals, or other custom entities managed within Bitrix24's data storage system. For example, a user might automate adding a new customer entity whenever a form is submitted on their website, or create a new deal entity when a sales opportunity arises.

Properties

Output

The node outputs an array of items where each item contains a json object representing the result of the add entity operation. The exact structure depends on the Bitrix24 API response but typically includes confirmation of the created entity and its properties.

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 add entities.
• Needs one of the supported authentication credentials configured in n8n:
  • OAuth2 credential (recommended for production)
  • Webhook URL credential
  • API key credential
• Relies on Bitrix24 API endpoints to perform operations.
• No additional external dependencies beyond standard HTTP requests to Bitrix24.

Troubleshooting

• Common Issues:

  • Authentication failures due to incorrect or expired credentials.
  • Insufficient permissions in Bitrix24 to add entities.
  • Invalid or missing required fields like Entity Name or Entity Code.
  • Network connectivity issues preventing API calls.

• Error Messages:

  • Errors returned from Bitrix24 API will be included in the output if "Continue On Fail" is enabled.
  • Typical errors include authorization errors, validation errors for entity fields, or API rate limits.

• Resolutions:

  • Verify that the selected authentication method is correctly configured and valid.
  • Ensure the user account has rights to create entities in Bitrix24.
  • Double-check all required input properties are provided and valid.
  • Check network connectivity and retry if transient errors occur.

Links and References

• Bitrix24 Official API Documentation
• Bitrix24 OAuth2 Authentication Guide
• n8n Documentation on Credentials