Bitrix24 Auxiliary icon

Bitrix24 Auxiliary

Управление вспомогательными сущностями в Bitrix24

Actions10

Overview

This node integrates with Bitrix24 to manage sales funnel statuses ("Статус воронки"). Specifically, the Create operation for the "Статус воронки" resource allows users to add new status entries within a specified sales funnel category. This is useful for automating and customizing sales pipeline stages in Bitrix24 CRM.

Common scenarios include:

  • Adding a single new status to a sales funnel to reflect a new stage in the sales process.
  • Creating multiple statuses at once to quickly set up or update a sales funnel.
  • Defining visual and semantic properties of each status (color, sort order, success/failure/process semantics).

Practical example:

  • A sales manager wants to add a new "Negotiation" stage with a specific color and sorting priority to an existing sales funnel category. They can use this node to create that status automatically without manual entry in Bitrix24.

Properties

Name Meaning
Category ID The ID of the sales funnel category where the status will be created.
Status Name The name/title of the status to create.
Status Sort Numeric value defining the order of the status within the funnel (default 100).
Status Color HEX color code representing the status color (e.g., "#00FF00").
Status Semantic Semantic meaning of the status: "Процесс" (Process), "Успех" (Success), or "Неудача" (Failure).
Multiple Items Boolean flag indicating whether to create multiple statuses in one execution.
Items When creating multiple statuses, this is a collection of statuses each with Name, Sort, Color, and Semantic.

Output

The output is a JSON array where each element corresponds to a processed status creation result. Each element includes:

  • success: boolean indicating if the creation was successful.
  • id: the unique identifier of the created status returned by Bitrix24.
  • All input fields used for the status creation (NAME, SORT, COLOR, SEMANTIC_INFO).
  • In case of errors (if continue on fail is enabled), an object with an error message.

No binary data is output by this node.

Example output item:

{
  "success": true,
  "id": "123",
  "NAME": "Negotiation",
  "SORT": 50,
  "COLOR": "#FF0000",
  "SEMANTIC_INFO": {
    "CODE": "P"
  },
  "CATEGORY_ID": "5",
  "ENTITY_ID": "DEAL_STAGE_5",
  "STATUS_ID": "5_50"
}

Dependencies

  • Requires a valid Bitrix24 API webhook URL credential configured in n8n.
  • Uses Bitrix24 REST API endpoints for CRM status management.
  • No additional external dependencies beyond axios HTTP client bundled with n8n.

Troubleshooting

  • Missing credentials or webhook URL: The node throws an error if no API credentials or webhook URL are provided. Ensure the Bitrix24 API credential is properly set up.
  • API errors from Bitrix24: Errors returned by Bitrix24 API (e.g., invalid category ID, duplicate status) are surfaced with descriptive messages. Check the error description for details.
  • Invalid property values: Providing invalid HEX colors or semantic codes may cause API rejection. Use correct formats as per Bitrix24 documentation.
  • Multiple items flag mismatch: If "Multiple Items" is true but no statuses are provided, no statuses will be created. Ensure the list is not empty.
  • Continue on Fail: If enabled, the node continues processing remaining items even if some fail, returning error objects for failed ones.

Links and References

Discussion