Delete#

Welcome to the Delete Knowledge Base. Learn how to safely and efficiently bulk-delete CRM records using HubSpot Workflows.

Overview#

Delete lets you delete CRM records — Contacts, Companies, Deals, Tickets, and custom objects — directly from HubSpot workflow actions.

Whether you are cleaning up unqualified leads, enforcing data retention policies, or removing test data, Delete processes deletions in the background and leaves an audit record of every action.

Capabilities#

• Workflow-Triggered Deletion: Add Delete as a custom action in any workflow to delete records that match your enrollment criteria.
• GDPR-Compliant Delete: For contacts, choose the GDPR Delete mode to permanently erase personal data and block re-creation with the same email address.
• Rate-Limited Batching: Delete processes enrolled records in batches of 100 and throttles its own enqueue rate to stay within HubSpot’s API limits, even when workflows enroll thousands of records at once.
• Automatic Retries: Transient HubSpot errors (5xx, 429) are retried with backoff before a batch is marked failed.
• Audit Trail: Every batch delete is logged with timestamp, object type, record IDs, deletion mode, triggering workflow, and final status.

Explore the sidebar to learn how to install Delete, use it in workflows, and understand the safety rails.