Actions89
- Direct API Actions
- CRM Actions
- Task Actions
- User Actions
- SPA Actions
- Activity Actions
- Automation Actions
- Document Generator Actions
- Data Storage Actions
- Chat Actions
Overview
This node integrates with the Bitrix24 CRM and business platform, specifically enabling users to create new CRM entities such as contacts, deals, leads, companies, quotes, invoices, products, and activities. It supports multiple authentication methods including OAuth2, webhook URLs, and API keys.
Common scenarios for this node include automating the creation of new customer records, sales deals, or leads directly from other systems or workflows without manual data entry. For example, when a new lead is captured via a web form, this node can automatically create a corresponding lead entity in Bitrix24 CRM, populating relevant fields like phone numbers and email addresses.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate with Bitrix24. Options: - OAuth2 (recommended for production) - Webhook URL (simpler but less secure) - API Key authentication |
| Entity | The type of CRM entity to create. Options: - Contact - Deal - Lead - Company - Quote - Invoice - Product - Activity |
| Deal Category | (Only for creating Deals) Select the deal category from available categories in Bitrix24. |
| Fields | A collection of fields to set on the created entity. Available fields depend on the selected entity type. Each field requires: - Field Name (selectable from entity-specific fields) - Field Value (string) |
| Phone Numbers | (For Contact, Lead, Company) Multiple phone numbers can be added. Each phone number includes: - Type (Work, Mobile, Home, Fax, Pager, Other) - Phone Number (string, e.g., +1234567890) |
| Email Addresses | (For Contact, Lead, Company) Multiple email addresses can be added. Each email address includes: - Type (Work, Home, Other) - Email Address (string, e.g., email@example.com) |
Output
The node outputs an array of items where each item contains a json object representing the newly created CRM entity as returned by the Bitrix24 API. This JSON includes all standard and custom fields that were set or generated during creation.
If the operation fails and "Continue On Fail" is enabled, the output will contain an error object with the error message, resource name, and timestamp.
The node does not output binary data.
Dependencies
- Requires access to a Bitrix24 account with appropriate permissions to create CRM entities.
- Requires one of the supported authentication methods configured in n8n:
- OAuth2 credentials
- Webhook URL credential
- API key credential
- Uses Bitrix24 REST API endpoints to perform operations.
- The node relies on internal helper functions to dynamically load available fields and deal categories from Bitrix24.
Troubleshooting
- Authentication errors: Ensure the chosen authentication method is correctly configured and has sufficient permissions to create CRM entities.
- Field loading issues: If fields do not load properly in the UI, verify network connectivity and API access rights.
- Invalid field values: Make sure field values conform to expected formats (e.g., phone numbers, emails).
- API rate limits or timeouts: Bitrix24 may throttle requests; consider adding delays or retries if encountering such errors.
- Error messages in output: When "Continue On Fail" is enabled, errors are returned in the output JSON. Review the error message for details and adjust parameters accordingly.