Bitrix24 icon

Bitrix24

Работа с Bitrix24 API

Overview

This node integrates with the Bitrix24 CRM system to manage Contact records. Specifically, the "Delete" operation allows users to remove a Contact record by its unique ID. This is useful in scenarios where contacts are no longer relevant or need to be cleaned up from the CRM database.

Practical examples include:

  • Automatically deleting contacts that have unsubscribed or requested removal.
  • Cleaning up test or duplicate contact entries as part of data maintenance workflows.

Properties

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

Output

The output is a JSON array containing the response from the Bitrix24 API for each deletion request. Each element corresponds to one input item processed and typically includes information about the success or failure of the deletion operation.

No binary data is output by this node.

Example output structure (simplified):

[
  {
    "result": true
  }
]

Where "result": true indicates successful deletion.

Dependencies

  • Requires an active Bitrix24 API connection configured with a valid webhook URL.
  • The webhook URL must have permissions to perform delete operations on Contact records.
  • Uses HTTP POST requests to Bitrix24 endpoints following the pattern: {webhookUrl}crm.contact.delete.json.

Troubleshooting

  • Missing Credentials or Webhook URL: The node will throw errors if credentials or the webhook URL are not set. Ensure the Bitrix24 API credential is properly configured in n8n.
  • Invalid or Nonexistent ID: If the provided Contact ID does not exist, the API may return an error. Verify the ID before attempting deletion.
  • API Errors: Network issues or permission problems can cause failures. Check API access rights and network connectivity.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if some deletions fail, returning error messages in the output.

Common error message example:

  • "Webhook URL is required!" — Indicates missing webhook configuration.
  • "No credentials got returned!" — Indicates missing or invalid API credentials.

Links and References

Discussion