Bitrix icon

Bitrix

Consume Bitrix24 REST API

Overview

This node integrates with the Bitrix24 REST API to perform operations on CRM entities. Specifically, for the Deal resource and the Delete operation, it deletes a deal record identified by its ID from the Bitrix24 CRM system.

Common scenarios where this node is useful include:

  • Automating cleanup of outdated or invalid deals in your CRM.
  • Integrating with other systems to remove deals when certain conditions are met.
  • Managing CRM data lifecycle programmatically within workflows.

Example: Automatically delete a deal after it has been marked as lost or completed in another system.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24 API. Options: OAuth2, Webhook
ID The unique identifier of the deal record to delete. Example: "12345"

Output

The node outputs JSON data representing the response from the Bitrix24 API after attempting to delete the deal. This typically includes confirmation of deletion or error details if the operation failed.

No binary data output is produced by this operation.

Dependencies

  • Requires valid authentication credentials for Bitrix24, either via OAuth2 or Webhook method.
  • The node depends on Bitrix24 REST API availability and correct permissions to delete deals.
  • No additional external dependencies beyond standard n8n environment and configured credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing deal ID will cause the operation to fail.
    • Insufficient permissions in Bitrix24 API credentials can prevent deletion.
    • Network or API downtime may cause request failures.
  • Error messages:

    • "Record not found" indicates the specified deal ID does not exist.
    • Authentication errors suggest invalid or expired credentials; re-authenticate or update credentials.
    • API rate limits or quota exceeded errors require waiting or adjusting usage.

Resolving these usually involves verifying the deal ID, checking credential validity, and ensuring API access rights.

Links and References

Discussion