Bitrix24

Interact with Bitrix24 CRM and business platform

Actions89

Overview

The Bitrix24 node integrates with the Bitrix24 CRM and business platform, enabling users to perform various operations on CRM entities. Specifically, the CRM - Update operation allows updating existing records such as contacts, deals, leads, companies, quotes, invoices, products, or activities within the Bitrix24 CRM.

This node is beneficial in scenarios where you need to automate updates to CRM data based on external triggers or workflows. For example:

Automatically updating a contact's phone number or email address when new information is received.
Modifying deal details after a status change in another system.
Updating lead information based on form submissions or marketing automation events.

Properties

Name	Meaning
Authentication	Method of authenticating with Bitrix24. Options: • OAuth2 (recommended for production) • Webhook (simpler but less secure) • API Key authentication
Entity	The type of CRM entity to update. Options: • Contact • Deal • Lead • Company • Quote • Invoice • Product • Activity
Record ID	The unique identifier of the record to update. This is required to specify which CRM record will be modified.
Fields	A collection of fields to update on the selected entity. Each field consists of: • Field Name: Selectable from available fields for the chosen entity type. • Field Value: The value to set for that field.
Phone Numbers	(For Contact, Lead, Company only) Multiple phone numbers can be added or updated. Each phone number includes: • Type (Work, Mobile, Home, Fax, Pager, Other) • Phone Number (e.g., +1234567890)
Email Addresses	(For Contact, Lead, Company only) Multiple email addresses can be added or updated. Each email includes: • Type (Work, Home, Other) • Email Address (e.g., email@example.com)

Output

The node outputs an array of JSON objects representing the result of the update operation for each input item. The json output typically contains the response from Bitrix24 API confirming the update or providing the updated record details.

If an error occurs and "Continue On Fail" is enabled, the output will include an object with an error message, the resource name, and a timestamp.

The node does not output binary data.

Dependencies

Requires connection to Bitrix24 via one of the supported authentication methods:
- OAuth2 authentication (recommended)
- Webhook URL
- API Key authentication
Requires appropriate credentials configured in n8n for the chosen authentication method.
Relies on Bitrix24 API endpoints to fetch entity fields dynamically and perform update operations.

Troubleshooting

Common Issues:
- Incorrect or missing Record ID: The update will fail if the specified record ID does not exist or is invalid.
- Insufficient permissions: The API credentials must have permission to update the selected entity.
- Invalid field names or values: Fields must match those available for the entity; otherwise, the API may reject the request.
- Network or authentication errors: Ensure credentials are valid and network connectivity to Bitrix24 is stable.
Error Messages:
- "Failed to load CRM fields": Occurs if the node cannot retrieve available fields for the selected entity. Check API access and entity type correctness.
- API errors returned from Bitrix24 during update will be surfaced in the error message. Review the message for details like permission denied, invalid data, or rate limits.
- If "Continue On Fail" is enabled, errors will be included in the output JSON with an error property instead of stopping execution.