Actions25
Overview
This node integrates with the Bitrix24 CRM system to manage Contact records via its API. Specifically, the Update Contact operation allows users to modify existing contact entries by specifying the contact's ID and the fields to update.
Common scenarios where this node is useful include:
- Automatically updating contact information in Bitrix24 when data changes elsewhere (e.g., from a form submission or another CRM).
- Synchronizing contact details between Bitrix24 and other systems.
- Bulk updating multiple contacts programmatically within an automation workflow.
For example, you could use this node to update a contact’s phone number and email address after receiving new data from a customer support system.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the contact record to update. Required for update operations. |
| Fields | A collection of fields to update on the contact. Each field consists of: |
| - Field Name: The name of the contact property to update (loaded dynamically). | |
| - Field Value: The new value to assign to that property. |
The "Fields" property supports multiple entries, allowing several fields to be updated in one request.
Output
The node outputs an array of JSON objects corresponding to each input item processed. For the Update operation, each output object contains the response from the Bitrix24 API indicating the success or failure of the update request.
Typical output structure includes:
result: An object containing details about the updated contact if successful.error: If an error occurs and "Continue On Fail" is enabled, an error message object is returned instead.
No binary data is produced by this node.
Dependencies
- Requires a valid Bitrix24 API webhook URL credential configured in n8n.
- Uses HTTP POST requests to Bitrix24 REST API endpoints specific to the CRM Contact resource.
- The webhook URL must have permissions to update contact records.
Troubleshooting
- Missing Credentials: The node will throw an error if no API credentials or webhook URL are provided. Ensure the Bitrix24 API credential is set up correctly.
- Invalid Contact ID: Providing a non-existent or incorrect contact ID will cause the API to return an error. Verify the ID before running the update.
- Field Names: Field names must match those defined in Bitrix24. Use the dynamic field loader to select valid fields.
- API Errors: Network issues or permission problems may cause API calls to fail. Check connectivity and API access rights.
- Error Handling: If "Continue On Fail" is enabled, errors for individual items will be returned as error messages in the output rather than stopping execution.
Links and References
- Bitrix24 REST API Documentation
- Bitrix24 CRM Contacts API
- n8n documentation on Creating Custom Nodes