HubSpot Contact Email Validation using Hunter.io - n8n Workflow

CRM Managers and Sales Operations teams using HubSpot who require clean data.
Users needing high-quality, verified email data for marketing campaigns.
Developers looking for a robust n8n workflow example of API rate limit handling.
Anyone seeking to leverage powerful n8n templates for contact data enrichment.

Maintaining data hygiene is crucial for effective sales and marketing. This essential n8n workflow template addresses the critical need for clean CRM data by systematically validating emails in HubSpot. Invalid email addresses lead to wasted resources and poor deliverability. This automation integrates HubSpot with Hunter.io (an email verification service) to check every contact that possesses an email but lacks a validation status. The architecture of this specific n8n workflow is designed to handle large datasets efficiently. It uses a looping structure and incorporates a critical rate-limiting Wait n8n node to ensure compliance with HubSpot API constraints. By implementing this powerful n8n workflow, you ensure your HubSpot records are consistently accurate, significantly improving sales and marketing outreach effectiveness.

This comprehensive n8n workflow operates through a structured sequence of steps designed for efficiency and API safety:

1. Initiation: The n8n trigger, configured for manual execution, starts the validation process on demand.


2. Contact Search: The initial HubSpot n8n node searches the CRM for contacts. Crucially, it filters for contacts that have an email address but do not yet have the custom property hunteremailvalidationstatus, ensuring only new or unverified records are processed.


3. Looping Preparation: The Loop Over Items (Split In Batches) n8n node handles iteration, splitting the list of contacts into individual items so they can be processed sequentially.


4. Email Verification: For each contact, the Hunter n8n node performs an Email Verification operation, using the contact’s email property. This determines the email’s validity.


5. HubSpot Update: An HTTP Request n8n node (acting as a HubSpot update function) then patches the original HubSpot contact record. It uses the contact's unique ID and updates custom properties like hunteremailvalidationstatus (using the data returned from the Hunter n8n node) and hunterverificationdate.


6. Rate Limit Management: A critical Wait n8n node pauses the execution for one second. This step is essential in the n8n workflow design to prevent hitting HubSpot's API rate limits, ensuring smooth operation over large datasets.


7. Loop Completion: The flow returns to the Loop Over Items n8n node via a placeholder, continuing until all contacts are processed.


8. Notification: Once the entire loop is complete and all contacts have been validated, the Send Email n8n node executes, sending a final notification that the verification batch is finished.

To start using this automated n8n workflow, follow these steps:

1. Import: Import the provided n8n workflow JSON into your n8n instance.


2. HubSpot Setup: Configure your HubSpot App Token credentials. This single credential is used by the HubSpot n8n node for searching and the HTTP Request n8n node for updating contacts. Ensure this credential has the necessary read and write permissions for contact properties.


3. Hunter.io Setup: Set up or link your Hunter.io API key credentials to the Hunter n8n node.


4. SMTP Configuration: Configure your SMTP credentials for the Send Email n8n node. Remember to customize the toEmail and fromEmail fields in this n8n node to match your notification preferences.


5. Custom Fields: Verify that the required custom fields—specifically hunteremailvalidationstatus and hunterverification_date—are created in your HubSpot account before running the n8n workflow, as the flow relies on patching these properties.


6. Execution: Activate the n8n workflow and click the 'Test workflow' n8n trigger to begin the manual data validation run.

When clicking ‘Test workflow’ (Manual n8n trigger): Initiates the entire data validation process on demand.
HubSpot n8n node (Search): Searches for contacts. Key configuration filters for contacts that have an email but are missing the custom hunteremailvalidation_status property.
Loop Over Items (SplitInBatches n8n node): Manages the iteration, processing the list of HubSpot contacts one item at a time for validation.
Hunter n8n node: Performs the core validation using the emailVerifier operation, receiving the email status (e.g., valid, invalid).
Add Hunter Details (Contact) (HTTP Request n8n node): Patches the HubSpot contact object ID. Key configuration dynamically inserts the Hunter validation status and the current date into the HubSpot record.
Wait n8n node: Essential for API governance; implements a 1-second delay between contact updates to respect HubSpot's rate limits.
Replace Me (NoOp n8n node): Acts as a necessary placeholder to connect the Wait node back to the Loop Over Items node, ensuring the continuous workflow loop.
Send Email n8n node: Sends an automated completion notice after the entire n8n workflow has finished processing all items.