Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

This node allows users to interact with Bitrix24's Smart Process Automation (SPA) entities, specifically enabling the deletion of SPA items. It is useful in scenarios where automated workflows need to remove specific SPA records based on business logic or external triggers.

For example, a user might want to delete a SPA item representing a completed task or an obsolete record automatically after certain conditions are met, such as after data synchronization or cleanup operations.

Properties

Name Meaning
Authentication Method to authenticate with Bitrix24: OAuth2 (recommended), Webhook (simpler), 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 be deleted

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will include confirmation of successful deletion or error details if the operation failed.

If the node encounters an error and "Continue On Fail" is enabled, it outputs an object containing the error message, the resource name ("spa"), and a timestamp.

No binary data output is produced by this node.

Dependencies

  • Requires authentication credentials for Bitrix24 via one of the supported methods: OAuth2, webhook URL, or API key.
  • Relies on Bitrix24 API endpoints to perform SPA item deletion.
  • The node uses internal helper functions to make standardized API calls to Bitrix24.

Troubleshooting

  • Common Issues:

    • Invalid or missing SPA Type ID or Item ID parameters will cause the deletion to fail.
    • Authentication failures due to incorrect or expired credentials.
    • Network or API rate limiting issues from Bitrix24.
  • Error Messages:

    • Errors returned from Bitrix24 API will be propagated; typical messages include "Item not found" or "Access denied".
    • If the node throws an error about missing parameters, ensure that both Type ID and Item ID are correctly set.
    • For authentication errors, verify that the selected authentication method is properly configured in n8n.
  • Resolution Tips:

    • Double-check the SPA Type ID corresponds to an existing Smart Process type.
    • Confirm the Item ID exists and is accessible with the provided credentials.
    • Use OAuth2 authentication for production environments to avoid security and permission issues.
    • Enable "Continue On Fail" to handle errors gracefully within workflows.

Links and References

Discussion