Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node integrates with the Bitrix24 CRM and business platform, specifically enabling the creation of CRM entities such as contacts, deals, leads, companies, quotes, invoices, products, and activities. It is useful for automating the addition of new records into Bitrix24 from workflows, such as adding a new contact after a form submission or creating a deal when an opportunity arises.

For example, you can use this node to:

  • Automatically create a new contact in Bitrix24 when a lead is captured on your website.
  • Add a new deal with specific category and custom fields when a sales opportunity is identified.
  • Insert a new company record with associated phone numbers and email addresses.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24. Options: OAuth2 (recommended for production), Webhook (simpler but less secure), API Key authentication.
Entity The type of CRM entity to create. Options include Contact, Deal, Lead, Company, Quote, Invoice, Product, Activity.
Deal Category (Only for Deal entity) Select the deal category to classify the deal. Categories are dynamically loaded from Bitrix24.
Fields Custom fields to set on the created entity. Available fields depend on the selected entity type and are dynamically loaded. Multiple fields can be added, each specifying the field name and its value.
Phone Numbers (For Contact, Lead, Company entities) List of phone numbers to associate with the entity. Each phone number includes a type (e.g., Work, Mobile, Home) and the actual number. Multiple phone numbers can be added.
Email Addresses (For Contact, Lead, Company entities) List of email addresses to associate with the entity. Each email address includes a type (e.g., Work, Home, Other) and the actual email. Multiple emails can be added.

Output

The node outputs an array of items where each item contains a json object representing the created CRM entity's data as returned by the Bitrix24 API. This typically includes the ID of the newly created entity and any other relevant information returned by the API.

If an error occurs and "Continue On Fail" is enabled, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.

The node does not output binary data.

Dependencies

  • Requires access to a Bitrix24 account with appropriate permissions to create CRM entities.
  • Requires configuration of one of the supported authentication methods:
    • OAuth2 credentials (recommended)
    • Webhook URL
    • API key credential
  • Uses Bitrix24 REST API endpoints to perform operations.
  • Dynamic loading of options (fields, deal categories) depends on successful API calls to Bitrix24.

Troubleshooting

  • Common issues:

    • Incorrect or expired authentication credentials will cause API call failures.
    • Selecting an unsupported or invalid entity type or field may result in errors.
    • Network connectivity issues can prevent communication with Bitrix24 API.
    • Missing required fields for certain entities may cause the creation to fail.

  • Error messages:

    • Errors thrown during execution will include the message from the Bitrix24 API or internal processing errors.
    • If "Continue On Fail" is enabled, errors are returned in the output JSON with details.

  • Resolutions:

    • Verify that authentication credentials are valid and have necessary permissions.
    • Ensure all required fields for the chosen entity are provided.
    • Check network connectivity and Bitrix24 service status.
    • Use the dynamic field loading feature to select valid fields.

Links and References

Discussion