Actions25
Overview
This node integrates with the Bitrix24 CRM system to manage Lead records. Specifically, the "Delete" operation for the Lead resource allows users to remove a lead record from their Bitrix24 account by specifying its unique ID.
Common scenarios where this node is beneficial include:
- Automating cleanup of outdated or invalid leads.
- Integrating with other workflows that require removing leads after certain conditions are met (e.g., lead converted or disqualified).
- Synchronizing lead data by deleting records in Bitrix24 when they are removed elsewhere.
Example: Automatically delete a lead in Bitrix24 when it is marked as lost in another system, by passing the lead's ID to this node.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the lead record to delete. This is required to specify which lead to remove. |
Output
The output JSON contains the response from the Bitrix24 API after attempting to delete the lead. Typically, it includes a success indicator or error information.
Example output structure:
{
"result": true
}
or, in case of failure:
{
"error": "Error message describing why deletion failed"
}
No binary data is output by this node.
Dependencies
- Requires an active Bitrix24 API connection configured with appropriate credentials (an API key or authentication token).
- The node uses the Bitrix24 webhook URL from the credentials to send API requests.
- Network access to the Bitrix24 API endpoints is necessary.
Troubleshooting
- Missing Credentials: If no credentials or webhook URL are provided, the node will throw an error indicating these are required.
- Invalid ID: Providing an incorrect or non-existent lead ID may result in an error or a response indicating the record was not found.
- API Errors: Network issues or Bitrix24 API errors (rate limits, permissions) can cause failures. The node returns error messages from the API to help diagnose.
- Continue on Fail: If enabled, the node will continue processing subsequent items even if one deletion fails, returning error details per item.
Links and References
- Bitrix24 REST API Documentation
- Bitrix24 Leads API Reference
- n8n documentation on creating custom nodes