Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

The node integrates with Bitrix24's Smart Process Automation (SPA) feature, specifically enabling the update of SPA items. It allows users to modify fields of an existing SPA item by specifying the item ID and the type of SPA entity. This is useful in scenarios where automated workflows or CRM processes require updating records dynamically based on external triggers or data changes.

For example, a user might want to update a customer support ticket's status or priority in Bitrix24 SPA when a related event occurs in another system, such as a new email or form submission.

Properties

Name Meaning
Authentication Method to authenticate with Bitrix24: OAuth2, Webhook URL, or API Key
Type ID The identifier of the Smart Process type to which the item belongs
Item ID The unique identifier of the SPA item to update
Fields Collection of fields to update on the SPA item. Each field includes:
- Field Name: select from available fields for the chosen SPA type
- Field Value: value to set for the field
Use JSON Format for Fields Whether to provide the fields as a JSON object instead of individual field entries
Fields (JSON) JSON object representing fields and their values to update (used if "Use JSON Format for Fields" is true)

Output

The node outputs an array of items, each containing a json property with the response from Bitrix24 after attempting to update the SPA item. The structure typically includes confirmation of the update or details about the updated item.

If an error occurs and the node is configured to continue on failure, the output will include an error field with the error message, the resource name, and a timestamp.

No binary data output is produced by this node.

Dependencies

  • Requires access to a Bitrix24 account with appropriate permissions to manage Smart Process Automation entities.
  • Requires authentication credentials configured in n8n, supporting OAuth2, webhook URL, or API key methods.
  • Relies on Bitrix24 API endpoints for SPA types, fields, and item updates.
  • Uses internal helper functions to make standardized API calls to Bitrix24.

Troubleshooting

  • Common Issues:

    • Incorrect or missing SPA Type ID or Item ID can cause failures in locating the item to update.
    • Providing invalid field names or values not matching the expected format may result in API errors.
    • Authentication misconfiguration can lead to authorization errors.

  • Error Messages:

    • Errors returned from Bitrix24 API are surfaced in the node output under the error field if "Continue On Fail" is enabled.
    • Common messages include "Failed to load SPA types," "Failed to load SPA fields," or specific API error messages indicating invalid parameters or permission issues.

  • Resolutions:

    • Verify that the SPA Type ID corresponds to an existing Smart Process type in Bitrix24.
    • Ensure the Item ID exists and is accessible with the provided credentials.
    • Double-check field names against those loaded dynamically for the selected SPA type.
    • Confirm authentication credentials are valid and have sufficient permissions.

Links and References

Discussion