Bitrix24 icon

Bitrix24

袪邪斜芯褌邪 褋 Bitrix24 API

Actions30

小屑邪褉褌-锌褉芯褑械褋褋 → 袨斜薪芯胁懈褌褜

AI-generated

Overview

This node interacts with the Bitrix24 API to perform CRUD operations on Smart Process entities. It supports creating, updating, retrieving, listing, and deleting records within a specified Smart Process type. The node is useful for automating data management tasks in Bitrix24's Smart Processes, such as managing custom business workflows or data records.

Use Case Examples

  1. Create a new record in a Smart Process by specifying the entity type and fields.
  2. Update an existing Smart Process record by ID with new field values.
  3. Retrieve a specific Smart Process record by ID or by filter criteria.
  4. List multiple Smart Process records with optional filtering and field selection, supporting pagination or limited results retrieval.

Properties

Name Meaning
entityTypeId Specifies the Smart Process type to operate on. This is required to identify which Smart Process the operation targets.
id The unique identifier of the Smart Process record. Required for update and delete operations.
inputFormat Defines the format of the input data for create and update operations. Can be 'form' for structured fields or 'json' for raw JSON input.
fieldsJson The JSON string representing the fields and their values for create or update operations when inputFormat is 'json'.
fields A collection of fields and their values for create or update operations when inputFormat is 'form'. Supports multiple fields with options for field name, value type (e.g., communication types), and value.

Output

JSON

  • result
    • item - The created or updated Smart Process record item.
    • items - An array of Smart Process records returned from list or get operations.
  • success - Indicates successful deletion of a Smart Process record.
  • id - The ID of the record affected by the operation, especially for delete.
  • error - Error message when a record is not found or an operation fails.

Dependencies

  • Bitrix24 API
  • An API key credential for Bitrix24 API authentication

Troubleshooting

  • Ensure the entityTypeId is correctly specified for Smart Process operations; missing or incorrect IDs will cause failures.
  • For update and delete operations, the record ID must be valid and exist in Bitrix24.
  • When using JSON input format, ensure the JSON is well-formed to avoid parsing errors.
  • API rate limits or network issues may cause request failures; handle errors and retry as needed.
  • If a record is not found during get or update operations, the node returns an error message indicating the record was not found.

Discussion