Actions10
Overview
This node integrates with Bitrix24 to manage sales funnels (referred to as "Воронка продаж" or "category" in the code). Specifically, the Update operation for the sales funnel resource allows users to update existing sales funnel categories in Bitrix24 CRM. It supports updating a single funnel or multiple funnels at once.
Common scenarios where this node is useful include:
- Modifying the name, sort order, or default status of an existing sales funnel.
- Bulk updating multiple sales funnels in one execution.
- Automating updates to sales funnel configurations based on external triggers or workflows.
Practical example:
- A company wants to rename a sales funnel stage and change its sorting priority automatically when a marketing campaign starts. This node can be used to update the funnel category accordingly via Bitrix24 API.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the sales funnel category to update. |
| Name | The new name for the sales funnel category. |
| Sort | Numeric value defining the sorting order of the sales funnel. Defaults to 100 if unset. |
| Is Default | Boolean flag indicating whether this funnel is the default one. |
| Multiple Items | Boolean flag to indicate if multiple funnel categories should be updated/created at once. |
| Items | When Multiple Items is true, this is a collection of funnel categories to create/update. Each item includes: Name, Sort, and Is Default fields. |
Output
The output is a JSON array where each element corresponds to the result of an individual update request. Each element contains:
success: Boolean indicating if the update was successful.id: The ID of the updated or created sales funnel category.- Other fields reflect the updated properties such as
name,sort, andisDefault.
If errors occur during processing, error objects with an error message field are included in the output array for those specific items.
No binary data output is produced by this node.
Dependencies
- Requires a valid Bitrix24 API webhook URL credential configured in n8n.
- Uses HTTP POST requests to Bitrix24 CRM endpoints for categories (
crm.category.update). - Optional environment variable
N8N_DEFAULT_LANGUAGEmay be set based on credentials but defaults to Russian ("ru").
Troubleshooting
- Missing Credentials: If no API credentials or webhook URL are provided, the node throws an error "No credentials got returned!" or "Webhook URL is required!".
- API Errors: Bitrix24 API errors return messages prefixed with "Bitrix24 API error:" followed by the error description from the API response.
- Partial Failures: When
continueOnFailis enabled, failed updates do not stop the entire execution; instead, error details are added to the output array. - Invalid IDs: Providing an invalid or non-existent funnel ID will cause the API to return an error.
- Incorrect Property Values: Ensure that required fields like
ID(for update) andNameare correctly set; missing these will cause failures.