Delete Documentation on OrangeMage Knowledge Base

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installing Delete#

Get Delete running in your HubSpot portal so you can start automating record deletions safely.

Requirements#

You must be a Super Admin in your HubSpot portal to install Delete.

Installation Steps#

Initiate the Install: Navigate to the OrangeMage Apps page and click on Add Delete to HubSpot. You will be redirected to the HubSpot OAuth authorization page.
Select Your Portal: Choose the HubSpot portal where you want to install Delete.
Grant Permissions: Review the requested permissions. Delete requires delete access across all standard and custom objects to function. Click Connect App.
Ready to Use: Once the OAuth flow completes, Delete is active. The “Delete Record” workflow action becomes available immediately — no additional configuration is required before your first workflow run.

Accessing Delete#

Delete does not have a standalone dashboard for daily use. Once installed and configured, it operates entirely within the HubSpot Workflows tool as a Custom Action.

Workflow Actions

Mon, 01 Jan 0001 00:00:00 +0000

Using Delete in Workflows#

Delete is designed to be triggered exclusively via HubSpot Workflows. This allows you to use HubSpot’s powerful enrollment triggers to define exactly which records should be deleted, and when.

Adding the Custom Action#

In HubSpot, navigate to Automation > Workflows and create or edit a workflow.
Set your enrollment triggers (e.g., Lead Status is Unqualified and Last Activity Date is more than 365 days ago).
Click the + icon to add an action.
Scroll down to the Connected Apps section and select Delete.
Choose the Delete Record action.

Two Deletion Modes#

When configuring the Delete action, you must choose how the record should be deleted. The available modes depend on the object type being enrolled.

Safety & Limits

Mon, 01 Jan 0001 00:00:00 +0000

Safety Rails & Auditing#

Automated deletion is powerful, but it carries inherent risk. A poorly configured workflow trigger could inadvertently wipe out a large segment of your database. Delete is built to throttle itself and leave a paper trail for every action it takes.

Per-Request Rate Limiting#

Delete caps how fast delete tasks can be enqueued to HubSpot. When a workflow enrolls a large batch of records, Delete does not fire them at HubSpot all at once — it processes them in batches of 100 and rate-limits the enqueue rate to a steady, sustainable throughput.

FAQ

Mon, 01 Jan 0001 00:00:00 +0000

Frequently Asked Questions#

Is it possible to recover deleted records?#

Delete instructs HubSpot to delete the records. For “Standard Delete” operations, depending on your portal settings, HubSpot may retain the records in a native recycle bin for a limited period (often up to 90 days) before final erasure. During this window, a Super Admin may be able to restore them natively in HubSpot. However, if you use the “GDPR Delete” mode, the deletion is permanent and immediate, and the record cannot be recovered.