Workflow: HubSpot Contact Email Validation with Hunter.io

Overall Goal

This workflow retrieves contacts from HubSpot that have an email address but haven't yet had their email validated by Hunter. It then iterates through each of these contacts, uses Hunter.io to verify their email, updates the contact record in HubSpot with the validation status and date, and finally sends a summary email notification upon completion.

How it Works (Step-by-Step Breakdown)

Node: "When clicking ‘Test workflow’" (Manual Trigger)

• Type: n8n-nodes-base.manualTrigger
• Purpose: Start the workflow manually via the n8n interface.
• Output: Triggers workflow execution.

Node: "HubSpot" (HubSpot)

• Type: n8n-nodes-base.hubspot
• Purpose: Fetch contacts from HubSpot.
• Configuration:
  • Authentication: App Token
  • Operation: Search for contacts
  • Return All: True
  • Filter Groups:
    • Contact HAS_PROPERTY email
    • Contact NOT_HAS_PROPERTY hunter_email_validation_status
• Output: List of contact objects.

Node: "Loop Over Items" (SplitInBatches)

• Type: n8n-nodes-base.splitInBatches
• Purpose: Process each contact one-by-one.
• Configuration:
  • Options > Reset: false
• Output:
  • Output 1 to "Hunter"
  • Output 2 to "Send Email"

Node: "Hunter" (Inside the loop)

• Type: n8n-nodes-base.hunter
• Purpose: Verify email with Hunter.io
• Configuration:
  • Operation: Email Verifier
  • Email: {{ $json.properties.email }}

Node: "Add Hunter Details (Contact)" (HTTP Request - Inside the loop)

• Type: n8n-nodes-base.httpRequest
• Purpose: Update HubSpot contact.
• Configuration:
  • Method: PATCH
  • URL: https://api.hubapi.com/crm/v3/objects/contacts/{{ $('Loop Over Items').item.json.id }}
  • Headers: Content-Type: application/json
  • Body (JSON):

    {
      "properties": {
        "hunter_email_validation_status": "{{ $json.status }}",
        "hunter_verification_date": "{{ $now.format('yyyy-MM-dd') }}"
      }
    }
    

Node: "Wait" (Inside the loop)

• Type: n8n-nodes-base.wait
• Purpose: Avoid API rate limits.
• Configuration: Wait for 1 second.

Node: "Replace Me" (NoOp - Inside the loop)

• Type: n8n-nodes-base.noOp
• Purpose: Junction node to complete the loop.

Node: "Send Email" (After the loop completes)

• Type: n8n-nodes-base.emailSend
• Purpose: Send summary notification.
• Configuration:
  • From Email: [email protected]
  • To Email: [email protected]
  • Subject: "Email Verification Completed for Your HubSpot Contacts"
  • HTML: Formatted confirmation message

Sticky Notes

• "HubSpot": Create custom properties (hunter_email_validation_status, hunter_verification_date).
• "Add Hunter Details": Ensure field names match HubSpot properties.
• "Wait": Prevent API rate limits.

How to Customize It

Trigger

• Replace Manual Trigger with Schedule Trigger (Cron) for automation.
• Optionally use HubSpot Trigger for new contact events.

HubSpot Node

• Create matching custom properties.
• Adjust filters and returned properties as needed.

Hunter Node

• Minimal customization needed.

HTTP Request Node

• Update JSON property names if renaming in HubSpot.
• Customize date format as needed.

Wait Node

• Adjust wait time to balance speed and API safety.

Email Node

• Customize email addresses, subject, and body.
• Add dynamic contact count with a Set or Function node.

Error Handling

• Add Error Trigger nodes.
• Use If nodes inside loop to act on certain statuses.

Use Cases

• Clean your email list.
• Enrich CRM data.
• Prep verified lists for campaigns.
• Automate contact hygiene on a schedule.

Required Credentials

HubSpot App Token

• Used by: HubSpot node and HTTP Request node
• Create a Private App in HubSpot with required scopes.

Hunter API

• Used by: Hunter node

SMTP

• Used by: Email Send node
• Configure host, port, username, and password.

---

Made with ❤️ using n8n by Akhil.