Hunter

The Hunter modules allow you to watch, create, update, list, and delete the campaigns, leads, and copy, find and verify an email address in your Hunter account.

Getting Started with Hunter

Prerequisites

  • A Hunter account

In order to use Hunter with Make, it is necessary to have a Hunter account. If you do not have one, you can create a Hunter account at hunter.io/users/sign_up.

Note

The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!

To connect your Hunter account to Make you need to obtain the API Key from your Hunter account and insert it in the Create a connection dialog in the Make module.

1. Log in to your Hunter account and open your Dashboard.

2. Click Your Profile Icon > API.

61f270670ee42.gif

3. Copy the API Key to your clipboard.

61f2706975352.png

4. Go to Make and open the Hunter module's Create a connection dialog.

61f2706a72ddc.gif

5. In the Connection name field, enter a name for the connection.

6. In the API Key field, enter the API key copied in step 3 and click Continue.

The connection has been established.

Search Leads

Lists leads.

Connection

Establish a connection to your Hunter account.

Lead List ID

Select the Lead List ID whose leads you want to list.

Email

Enter the lead's email address you want to search.

First Name

Enter the lead's first name to search for the leads with the specified name.

Last Name

Enter the lead's last name to search for the leads with the specified name.

Position

Enter the job title to search for the leads with the specified position.

Company

Enter the company name to search for the leads with the specified name.

Industry

Enter the industry name to search for the leads with the specified industry.

Website

Enter the lead's or lead's company website URL address

Country Code

Enter the lead's country code to search for the leads with the specified country code.

Company Size

Enter the lead's company size to search the leads that belong to the specified company size.

Source

Enter the lead's source you want to search.

Twitter

Enter the lead's or lead's company Twitter's account URL address to search the leads with the specified account.

LinkedIn URL

Enter the lead's or lead's company LinkedIn's account URL address to search the leads with the specified account.

Phone Number

Enter the lead's phone number to search the leads with the specified number.

Sync Status

Select the lead's sync status:

  • Pending

  • Error

  • Success

Sending Status

Select the lead's sending status:

  • Clicked

  • Opened

  • Sent

  • Pending

  • Error

  • Bounced

  • Unsubscribed

  • Replied

Last Activity At

Enter the date and time of the lead's last activity.

Query

Enter a keyword or phrase to search the leads based on the specified query.

Limit

Set the maximum number of leads Make should return during one scenario execution cycle.

Get a Lead

Gets a lead.

Connection

Establish a connection to your Hunter account.

Lead ID

Select the Lead ID whose details you want to retrieve.

Create a Lead

Creates a lead.

Connection

Establish a connection to your Hunter account.

Email

Enter the lead's email address.

First Name

Enter the lead's first name.

Last Name

Enter the lead's last name.

Position

Enter the lead's job title or position

Company

Enter the lead's company name.

Company Industry

Enter the lead's company industry is into. For example, e-commerce.

Company Size

Enter the lead's company employee size. For example, 50-100.

Confidence Score

Enter the confidence score percentage that the lead might convert into a customer. For example, 80%.

Website

Enter the lead's company website URL address.

Country Code

Enter the lead company's country code.

LinkedIn URL

Enter the lead company's country code.

Phone Number

Enter the lead's company's contact phone number.

Twitter

Enter the lead's company's Twitter URL account.

Notes

Enter any additional information about the lead or lead's company which you would like to mention.

Source

Enter the source details from where you received the lead's information. For example, Webinar.

Leads List ID

Select the Leads List ID to which you want to add the contact.

Custom Attributes

Add the custom fields and their values. For example, Company Address.

Update a Lead

Updates a lead.

Connection

Establish a connection to your Hunter account.

Lead ID

Select the Lead ID whose details you want to update.

Email

Enter the lead's email address.

First Name

Enter the lead's first name.

Last Name

Enter the lead's last name.

Position

Enter the lead's job title or position

Company

Enter the lead's company name.

Company Industry

Enter the lead's company industry is into. For example, e-commerce.

Company Size

Enter the lead's company employee size. For example, 50-100.

Confidence Score

Enter the confidence score percentage that the lead might convert into a customer. For example, 80%.

Website

Enter the lead's company website URL address.

Country Code

Enter the lead company's country code.

LinkedIn URL

Enter the lead company's country code.

Phone Number

Enter the lead's company's contact phone number.

Twitter

Enter the lead's company's Twitter URL account.

Notes

Enter any additional information about the lead or lead's company which you would like to mention.

Source

Enter the source details from where you received the lead's information. For example, Webinar.

Leads List ID

Select the Leads List ID to which you want to add the contact.

Custom Attributes

Add the custom fields and their values. For example, Company Address.

Delete a Lead

Deletes a lead.

Connection

Establish a connection to your Hunter account.

Lead ID

Select the Lead ID you want to delete.

Add Receipts

Creates one or several recipients.

Connection

Establish a connection to your Hunter account.

Campaign ID

Select the Campaign ID to which you want to add the recipients.

Emails

Add the email address of the recipients to whom you want to send the campaign.

Count Emails

Checks how many email addresses are there for one domain or one company.

Search By

Select the option to search the emails.

Domain

Enter the domain address to search the emails only with the specified

Company

Enter the company name to search the email address of the specified company.

Type

Select the email type:

  • Generic

  • Personal

Find an Email

Generates or retrieves the most likely email address from a domain name, first name, and last name.

Connection

Establish a connection to your Hunter account.

Search By

Select the option to search the email:

  • By Company

  • By Email

Domain

Enter the domain details of the email address whose details you want to retrieve.

Company ID

Enter the Company ID of the email address whose details you want to retrieve.

First Name

Enter the contact's first name whose email address you are searching for.

Last Name

Enter the contact's last name whose email address you are searching for.

Full Name

Enter the contact's full name whose email address you are searching for.

Max Duration

Enter the maximum duration (in seconds) of the request. You must provide a range between 3 and 20.

Verify an Email

Verifies the deliverability of an email address.

Connection

Establish a connection to your Hunter account.

Email

Enter the email address which you want to verify.

Watch Campaigns

Triggers when a new campaign is available to your account.

Connection

Establish a connection to your Hunter account.

Limit

Set the maximum number of campaigns Make should return during one scenario execution cycle.

Make an API Call

Performs an arbitrary authorized API call.

Connection

Establish a connection to your Hunter account.

URL

Enter a path relative to https://api.hunter.io/. For example: /v2/leads

Note

For the list of available endpoints, refer to the Hunter API Documentation.

Method

Select the HTTP method you want to use:

GET to retrieve information for an entry.

POST to create a new entry.

PUT to update/replace an existing entry.

PATCH to make a partial entry update.

DELETE to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Campaigns

The following API call returns all the campaigns from your Hunter account:

URL: /v2/campaigns

Method: GET

61f2706cac12b.png

Matches of the search can be found in the module's Output under Bundle > Body > data > campaigns. In our example, 2 campaigns were returned:

61f2706dbdbef.png