Hunter.io Action Block

What it does: Find and verify email addresses using Hunter.io's email discovery and verification API.

When to Use This

Use the Hunter.io action when you need to:

• ✅ Find email addresses for leads and prospects
• ✅ Verify email addresses before sending campaigns
• ✅ Enrich contact data with email information
• ✅ Build prospecting lists automatically
• ✅ Validate form submissions
• ✅ Find decision-makers at target companies

Example: When researching a company, automatically find email addresses for key contacts like the CEO, CTO, or marketing manager.

Features

• Email Finder: Discover email addresses by name and domain
• Domain Search: Find all email addresses from a company domain
• Email Verification: Check if an email address is valid
• Company Data: Get company information and patterns
• Confidence Score: Reliability rating for each result
• Email Pattern Detection: Identify naming conventions
• API Integration: Seamless Hunter.io API access
• Variable Support: Use workflow data in searches

Setup

1. Connect Hunter.io Account

1. Get your Hunter.io API key from hunter.io/api-keys (opens in a new tab)
2. Click Add Credentials
3. Enter your API key
4. Save credentials

2. Select Action Type

Choose what you want to do:

• Email Finder: Find email by name and company
• Domain Search: Find all emails from domain
• Email Verifier: Verify email validity
• Count: Check available emails for domain

Email Finder

Find a specific person's email address.

Required Fields

First Name:

{{contact.firstName}}
John

Last Name:

{{contact.lastName}}
Doe

Company Domain:

{{company.domain}}
example.com
google.com

Optional Fields

Full Name: Alternative to first/last name

{{contact.fullName}}
John Doe

Company Name: Company name (if domain unknown)

{{company.name}}
Acme Corporation

Response Data

Email Address: Found email

john.doe@example.com

Confidence Score: Reliability (0-100)

95 = Very confident
75 = Confident
50 = Uncertain
25 = Low confidence

Sources: Where email was found

Website
LinkedIn
GitHub
Social Media

Verification Status:

valid = Email exists
invalid = Email doesn't exist
accept_all = Server accepts all emails
unknown = Cannot verify

Position: Person's job title

CEO
Marketing Manager
Software Engineer

Department: Person's department

executive
marketing
engineering
sales

Domain Search

Find all email addresses associated with a domain.

Required Field

Domain:

{{company.domain}}
microsoft.com
apple.com

Optional Filters

Type: Email type filter

personal = Personal emails
generic = Generic emails (info@, contact@)

Limit: Max number of results

10
50
100

Offset: Pagination offset

0
10
20

Department: Filter by department

executive
marketing
engineering
sales
finance

Seniority: Filter by position level

executive
senior
junior

Response Data

Emails: Array of email addresses with details

[
  {
    value: "john.doe@example.com",
    type: "personal",
    confidence: 95,
    firstName: "John",
    lastName: "Doe",
    position: "CEO",
    department: "executive"
  },
  ...
]

Pattern: Email naming pattern

{first}.{last}@domain.com
{first}{last}@domain.com
{f}{last}@domain.com

Organization: Company name

Example Corporation

Total Results: Available email count

45

Email Verifier

Verify if an email address is valid and deliverable.

Required Field

Email Address:

{{user.email}}
john.doe@example.com

Response Data

Result: Verification status

deliverable = Valid email
undeliverable = Invalid email
risky = Might bounce
unknown = Cannot verify

Score: Deliverability score (0-100)

90-100 = Excellent
70-89 = Good
50-69 = Risky
0-49 = Poor

Email Details:

Format Valid: true/false
MX Records: true/false
SMTP Valid: true/false
Accept All: true/false
Disposable: true/false
Webmail: true/false

Sources: Where email found (if in database)

Response Mapping

Map Hunter.io response to workflow variables:

Email Finder Results:

Email → {{hunter.email}}
Confidence → {{hunter.confidence}}
First Name → {{hunter.firstName}}
Last Name → {{hunter.lastName}}
Position → {{hunter.position}}
Department → {{hunter.department}}
Verification Status → {{hunter.status}}
Sources → {{hunter.sources}}

Domain Search Results:

Emails → {{hunter.emails}}
Pattern → {{hunter.pattern}}
Total → {{hunter.total}}
Organization → {{hunter.organization}}

Verifier Results:

Result → {{hunter.result}}
Score → {{hunter.score}}
Format Valid → {{hunter.formatValid}}
MX Records → {{hunter.mxRecords}}
SMTP Valid → {{hunter.smtpValid}}
Disposable → {{hunter.disposable}}

Common Use Cases

1. Lead Enrichment

Trigger: New lead added to CRM Hunter.io: Find email

First Name: {{lead.firstName}}
Last Name: {{lead.lastName}}
Domain: {{lead.company.domain}}

If found → Update CRM with email
If confidence > 80 → Mark as verified

2. Email Validation

Trigger: Form submission Hunter.io: Verify email

Email: {{form.email}}

If deliverable → Accept submission
If undeliverable → Request correction
If risky → Flag for review

3. Prospecting Automation

Trigger: Target company identified Hunter.io: Domain search

Domain: {{target.domain}}
Department: executive
Seniority: executive

→ Find C-level contacts
→ Add to prospecting list
→ Initiate outreach workflow

4. Contact Discovery

Trigger: Research list uploaded Hunter.io: Bulk email finder

For each contact:
  Find email using name + company
  If confidence > 70:
    Add to outreach list
  Else:
    Flag for manual research

5. Email List Cleaning

Trigger: Scheduled (monthly) Hunter.io: Verify contacts

For each contact in database:
  Verify email
  If undeliverable:
    Mark as invalid
    Remove from email campaigns
  If risky:
    Flag for review

Best Practices

Email Discovery

• ✅ Provide accurate first and last names
• ✅ Use company domains, not email providers
• ✅ Check confidence scores before using
• ✅ Verify high-value contacts
• ✅ Respect data usage limits

Email Verification

• ✅ Verify emails before campaigns
• ✅ Remove undeliverable emails promptly
• ✅ Review risky emails manually
• ✅ Re-verify periodically (quarterly)
• ✅ Handle accept_all servers carefully

Compliance

• ✅ Follow GDPR and privacy regulations
• ✅ Respect opt-out requests
• ✅ Use emails for legitimate business purposes
• ✅ Don't spam discovered emails
• ✅ Maintain proper consent records

Performance

• ✅ Cache results to save API calls
• ✅ Batch searches when possible
• ✅ Monitor monthly quota usage
• ✅ Implement rate limiting
• ✅ Handle errors gracefully

Troubleshooting

Email Not Found

Reasons:

• Person not in Hunter.io database
• Incorrect name spelling
• Wrong company domain
• Person uses different email

Solutions:

• Verify spelling
• Try alternative name formats
• Check company domain
• Use domain search for patterns

Low Confidence Score

What to do:

• Verify with other sources
• Use email verifier
• Try domain search for pattern
• Consider manual verification

Verification Returns "Unknown"

Causes:

• Server blocks verification attempts
• Temporary connectivity issues
• Accept-all mail server
• Privacy protection enabled

Actions:

• Retry later
• Use alternate verification method
• Assess risk tolerance
• Manual verification if critical

API Quota Exceeded

Solutions:

• Upgrade Hunter.io plan
• Optimize query frequency
• Cache previous results
• Prioritize high-value searches

Limitations

API Limits (Based on Plan)

Free Plan:

• 25 searches/month
• 50 verifications/month

Starter Plan:

• 500 searches/month
• 1,000 verifications/month

Growth Plan:

• 2,500 searches/month
• 5,000 verifications/month

Business Plan:

• 10,000+ searches/month
• 20,000+ verifications/month

Rate Limits

• Max 10 requests per second
• Burst tolerance for occasional spikes
• Longer delays between requests recommended

Data Accuracy

• Results depend on public data availability
• Confidence scores indicate reliability
• Some emails may be outdated
• Verification has ~95% accuracy

Example Workflow

Flow:

1. New lead enters system
2. Find email using Hunter.io
3. Check if email found
4. Verify confidence score
5. If confident, verify deliverability
6. If deliverable, add to campaign
7. Otherwise flag for manual review
8. Workflow complete

Related Blocks

• Condition: Check confidence scores
• HTTP Request: Additional API integrations
• Set Variable: Store email data
• Loop: Process multiple contacts
• HubSpot/CRM: Update contact records

Need Help?

• Check Hunter.io API documentation
• Review monthly quota usage in dashboard
• Test with known emails first
• Monitor confidence scores
• Use domain search to understand patterns
• Contact Hunter.io support for API issues