Bitrix24 icon

Bitrix24

Work with Bitrix24 API

Overview

This node integrates with the Bitrix24 CRM system to manage Contact records. Specifically, the Delete operation for the Contact resource allows users to remove a contact record from their Bitrix24 account by specifying its unique ID.

Common scenarios where this node is beneficial include:

  • Automating cleanup of outdated or duplicate contacts in Bitrix24.
  • Integrating with other systems to synchronize contact deletions.
  • Managing contact lifecycle within automated workflows.

Example use case: Automatically delete a contact in Bitrix24 when it is removed from an external database or application, ensuring data consistency across platforms.

Properties

Name Meaning
ID The unique identifier of the Contact record to delete. This is a required string input.

Output

The output JSON contains the response from the Bitrix24 API after attempting to delete the contact. Typically, it includes a success indicator or error information.

Example structure (simplified):

{
  "result": true
}

or in case of failure:

{
  "error": "Error message describing why deletion failed"
}

No binary data is output by this operation.

Dependencies

  • Requires an active connection to Bitrix24 via an API authentication token configured in n8n credentials.
  • Needs the Bitrix24 webhook URL to construct API endpoints.
  • Uses HTTP POST requests to Bitrix24 REST API endpoints.

Troubleshooting

  • Missing Credentials or Webhook URL: The node will throw errors if the API credentials or webhook URL are not set or invalid. Ensure that the Bitrix24 API credential is properly configured and contains a valid webhook URL.
  • Invalid ID: If the provided Contact ID does not exist or is incorrect, the API may return an error or indicate that the record was not found.
  • API Errors: Network issues or Bitrix24 service problems can cause request failures. Check connectivity and Bitrix24 service status.
  • Continue on Fail: If enabled, the node will continue processing subsequent items even if one deletion fails, returning error details in the output.

Links and References

Discussion