Actions31
- Company Actions
- Contact Actions
- Deal Actions
- Item Actions
- Lead Actions
- User Custom Method Actions
Overview
This node integrates with the Bitrix24 REST API to update a Lead record. It allows users to modify existing lead data by specifying the record ID and providing new values either as individual fields or as a raw JSON object. This is useful in scenarios where you want to automate updates to leads based on external triggers, such as updating lead status after a form submission or enriching lead information from another system.
Practical examples:
- Automatically update a lead’s contact details when a customer submits updated information.
- Change the lead status or assign it to a different sales representative based on workflow conditions.
- Bulk update multiple lead records by looping over input data and calling this node for each lead.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Bitrix24 API: OAuth2 or Webhook |
| ID | The unique identifier of the lead record to update (required) |
| Input Type | How to provide the update data: - Using Fields: Specify individual field names and values - Using JSON: Provide the entire update payload as raw JSON |
| Fields | When using "Using Fields" input type, specify one or more field name-value pairs to update |
| JSON Body | When using "Using JSON" input type, provide the complete update data as a JSON object |
Output
The node outputs the response from the Bitrix24 API after attempting to update the lead. The output is structured as JSON containing the result of the update operation, typically including success status and any updated lead data returned by the API.
If the node supports binary data output (not indicated here), it would represent attachments or files related to the lead, but this node primarily deals with JSON data.
Dependencies
- Requires an active Bitrix24 account with API access.
- Needs authentication credentials configured in n8n, either via OAuth2 or Webhook method.
- Network access to Bitrix24 REST API endpoints.
Troubleshooting
- Invalid ID error: Ensure the lead ID provided exists and is correct.
- Authentication failures: Verify that the API credentials are valid and have sufficient permissions to update leads.
- Malformed JSON: When using the JSON input type, ensure the JSON body is correctly formatted.
- Field validation errors: Some fields may require specific formats or values; check Bitrix24 API documentation for field constraints.
- API rate limits: If many updates are performed rapidly, Bitrix24 may throttle requests; implement retries or delays if needed.
Links and References
- Bitrix24 REST API Documentation
- n8n Expressions Documentation (for dynamic field value expressions)