Bulk delete HubSpot contacts from uploaded Excel CSV file
Bulk Contact Deletion from HubSpot via Uploaded Excel / CSV File This workflow allows you to automate the deletion of HubSpot contacts based on email address...
🔌 Nodes & Integrations Used (2)
📖 Implementation & Setup Guide
Bulk Contact Deletion from HubSpot via Uploaded Excel / CSV File
This workflow allows you to automate the deletion of HubSpot contacts based on email addresses provided in an uploaded Excel (`.xlsx`) file. It's ideal for bulk-cleaning outdated or invalid contact data.
---
✅ Prerequisites
Before using this workflow, ensure you have the following:
- A valid **HubSpot App Token** with permissions to search and delete contacts.
- An Excel (`.xlsx`) file with a column labeled `emails` containing the contact emails to be deleted.
- n8n self-hosted or cloud environment with:
- - **Webhook** node enabled and accessible.
- - **HubSpot** node credentials configured.
- Basic familiarity with n8n node configuration for custom adjustments (optional).
---
📃Sample Document

[Download](https://docs.google.com/spreadsheets/d/1PsulQO-io1VKokxeNgGA0oGc4QVYhLUJ/edit?usp=sharing&ouid=117854718738214515668&rtpof=true&sd=true) ---
🧠 n8n Workflow: Delete HubSpot Contacts from an Uploaded Excel File
This n8n workflow allows you to upload an Excel file containing contact email addresses. It will check each one in HubSpot and delete the contact if it exists.
---
🔗 Workflow Overview
📥 1. Trigger via Webhook (POST) The workflow starts when a `.xlsx` file is uploaded via an HTTP `POST` request to the webhook. This Excel file should contain a column with contact email addresses.
---
📄 2. Extract Data from Excel The uploaded file is parsed, and its rows are converted into structured JSON items, making each email address available for further processing.
---
🧹 3. Normalize Data The data is cleaned and normalized — for example, mapping column headers (e.g., `emails`) into a standard `email` field, ensuring consistent downstream logic.
---
🔁 4. Loop Through Contacts Each row (contact) is processed individually using batch looping. This allows for fine-grained error handling and sequential processing.
---
🔎 5. Search for Contact in HubSpot For each contact, a search query is made in HubSpot based on the email address. The workflow only fetches the first result (if any).
---
🧪 6. Check if Contact Exists An IF condition checks whether the contact was found (i.e., if a HubSpot contact ID exists): - ✅ **Yes** → proceed to delete the contact. - ❌ **No** → skip deletion and continue to the next.
---
🗑️ 7. Delete Contact If a contact exists, it is deleted from HubSpot using its internal contact ID.
---
🛠️ 8. Optional Placeholder for Post-Processing A placeholder node named **“Replace Me”** is included for any custom logic you may want to add after the deletion step, such as: - Logging - Notifications - Writing to external storage
---
✅ Use Cases
- Bulk delete old or bounced email addresses from HubSpot.
- Clean up contacts based on external suppression lists.
- Automate regular CRM hygiene processes.
---
💡 Suggested Enhancements
- ✍️ Log results to Google Sheets or a database
- 📬 Send completion report via email or Slack
- 🔁 Add retry logic for temporary API failures
- 🔍 Validate email format before making requests
---
📎 Requirements
- n8n (self-hosted or cloud)
- HubSpot App Token (set up in n8n credentials)
- Excel file (.xlsx) with a column for `email`
---
📦 Files
No external files are required. All logic is contained within the n8n workflow.
---
🚀 Getting Started
- Deploy the workflow in n8n.
- Copy the webhook URL and use it in your app or API client (like Postman).
- Upload an Excel file containing contact emails via POST request.
- Watch as it searches and deletes matches in HubSpot.
⚡ How to import this workflow into n8n:
- Click the Direct Download JSON button above to save
Bulk delete HubSpot contacts from uploaded Excel_CSV file.json. - Log in to your n8n Cloud or self-hosted n8n instance.
- In your workflow canvas, click the menu in top-right and select Import from File (or paste the JSON directly).
- Configure your credentials (e.g. API keys, database URLs) in the corresponding node settings.
- Click Execute Workflow to test and switch to Active!
Related Email & Outreach Workflows
View All in Email & Outreach →Abandoned cart recovery for Shopify via Gmail Google Sheets T
Who is this for? This template is ideal for solo store owners, eCommerce marketers, automation beginners, or anyone using Shopify and Gmail who wants to reco...
Add new leads in Lemlist from Airtable
This workflow allows you to add new leads in Lemlist from Airtable. !workflow-screenshot Airtable node: This node lists all the emails that are stored in you...
Add Subscriber and Send Email Campaign
Production-ready n8n automation template for Add Subscriber and Send Email Campaign built by AhiXLight. Seamlessly connects Sendy with 3 configured nodes.
Add new contacts from HubSpot to the email list in Mailchimp
This workflow adds new HubSpot contacts to the Mailchimp email list. Prerequisites - HubSpot account and HubSpot credentials - Mailchimp account and Mailchim...