Bitrix24

Overview

This node integrates with the Bitrix24 CRM and business platform, enabling users to interact programmatically with various Bitrix24 resources such as contacts, deals, leads, companies, quotes, invoices, products, activities, and Smart Process Automation (SPA) entities. It supports multiple authentication methods including OAuth2, webhook URLs, and API keys.

Typical use cases include automating CRM data management tasks like creating or updating contacts and deals, retrieving entity fields dynamically, managing deal categories, and working with custom SPA types. For example, a user might automate lead creation from form submissions or synchronize Bitrix24 contacts with another system.

Properties

Output

The node outputs an array of items where each item contains a json object representing the response from Bitrix24 for the requested resource operation. The structure of this JSON depends on the specific resource and operation invoked but generally includes the data retrieved or affected in Bitrix24.

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

The node does not explicitly handle binary data output.

Dependencies

• Requires valid credentials for Bitrix24 via one of the supported authentication methods.
• Uses internal helper functions to make standardized API calls to Bitrix24 endpoints.
• Depends on dynamic loading of resource handlers based on the selected resource to process requests.

Troubleshooting

• Common Issues:

  • Incorrect or expired authentication credentials can cause authorization failures.
  • Selecting unsupported or unavailable resources may result in errors.
  • Network connectivity issues can prevent API calls from succeeding.
  • Dynamic loading of resource fields or types may fail if Bitrix24 API changes or returns unexpected data.

• Error Messages:

  • Errors thrown during execution will include the message from the underlying API call or processing step.
  • If "Continue On Fail" is enabled, errors are returned in the output JSON under the error key.

• Resolutions:

  • Verify that the chosen authentication method is correctly configured and credentials are valid.
  • Ensure the Bitrix24 instance is accessible and the API endpoints are reachable.
  • Check that the selected resource and operation are supported by your Bitrix24 plan and API version.
  • Review API limits and permissions in Bitrix24 to avoid access denials.

Links and References

• Bitrix24 Official API Documentation
• Bitrix24 CRM Overview
• OAuth2 Authentication Guide