Hunter Integration — ModuleX AI

Field	Description	Required	Format
Hunter API Key	Your Hunter API key from hunter.io/api-keys	Yes	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

account_information — Get information about your Hunter account

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "first_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "First Name"
    },
    "last_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Name"
    },
    "plan_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Plan Name"
    },
    "plan_level": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Plan Level"
    },
    "reset_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Reset Date"
    },
    "team_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Team Id"
    },
    "calls_used": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Calls Used"
    },
    "calls_available": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Calls Available"
    }
  },
  "required": [
    "success"
  ],
  "title": "AccountInformationOutput",
  "type": "object"
}

combined_enrichment — Returns all the information associated with an email address and its domain name

Parameters

string

required

The email address you want to find information about

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "CombinedEnrichmentOutput",
  "type": "object"
}

create_lead — Create a new lead in your Hunter account

Parameters

string

required

The email address of the lead

string

The first name of the lead

string

The last name of the lead

string

The job title of the lead

string

The name of the company the lead is working in

string

The sector of the company. Allowed values: Animal, Art & Entertainment, Automotive, Beauty & Fitness, Books & Literature, Education & Career, Finance, Food & Drink, Game, Health, Hobby & Leisure, Home & Garden, Industry, Internet & Telecom, Law & Government, Manufacturing, News, Real Estate, Science, Retail, Sport, Technology, Travel

string

The size of the company the lead is working in

integer

Estimation of the probability the email address returned is correct, between 0 and 100

string

The domain name of the company

string

The country of the lead (ISO 3166-1 alpha-2 standard)

string

The address of the public profile on LinkedIn

string

The phone number of the lead

string

The Twitter handle of the lead

string

Some personal notes about the lead

string

The source where the lead has been found

string

The identifier of the list the lead belongs to. If not specified, the lead is saved in the last list created

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "first_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "First Name"
    },
    "last_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Name"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateLeadOutput",
  "type": "object"
}

delete_lead — Delete an existing lead from your Hunter account

Parameters

string

required

The unique identifier of the lead

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteLeadOutput",
  "type": "object"
}

domain_search — Search all the email addresses corresponding to one website or company

Parameters

string

Domain name from which you want to find the email addresses. For example, ‘stripe.com’. Either domain or company must be provided

string

The company name from which you want to find the email addresses. For example, ‘stripe’. Either domain or company must be provided

integer

required

Specifies the max number of email addresses to return (Default: 100)

string

Get only personal or generic email addresses. Allowed values: personal, generic

string

Get only email addresses for people with the selected seniority level(s). Comma-separated values: junior, senior, executive

string

Get only email addresses for people working in the selected department(s). Comma-separated values: executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Domain"
    },
    "disposable": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Disposable"
    },
    "webmail": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Webmail"
    },
    "accept_all": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Accept All"
    },
    "pattern": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Pattern"
    },
    "organization": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Organization"
    },
    "emails": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Emails",
      "type": "array"
    },
    "total_results": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total Results"
    }
  },
  "required": [
    "success"
  ],
  "title": "DomainSearchOutput",
  "type": "object"
}

email_count — Get the number of email addresses Hunter has for one domain or company

Parameters

string

Domain name from which you want to find the email addresses. For example, ‘stripe.com’. Either domain or company must be provided

string

The company name from which you want to find the email addresses. For example, ‘stripe’. Either domain or company must be provided

string

Get only personal or generic email addresses. Allowed values: personal, generic

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "total": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total"
    },
    "personal_emails": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Personal Emails"
    },
    "generic_emails": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Generic Emails"
    },
    "department": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Department"
    }
  },
  "required": [
    "success"
  ],
  "title": "EmailCountOutput",
  "type": "object"
}

email_finder — Find the most likely email address from a domain name, a first name and a last name

Parameters

string

Domain name from which you want to find the email addresses. For example, ‘stripe.com’. Either domain or company must be provided

string

The company name from which you want to find the email addresses. For example, ‘stripe’. Either domain or company must be provided

string

required

The person’s first name

string

required

The person’s last name

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "first_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "First Name"
    },
    "last_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Name"
    },
    "score": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Score"
    },
    "domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Domain"
    },
    "accept_all": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Accept All"
    },
    "position": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Position"
    },
    "twitter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Twitter"
    },
    "linkedin_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Linkedin Url"
    },
    "phone_number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Phone Number"
    },
    "company": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company"
    },
    "sources": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Sources",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "EmailFinderOutput",
  "type": "object"
}

email_verifier — Check the deliverability of a given email address, verify if it has been found in Hunter's database, and return their sources

Parameters

string

required

The email address you want to verify

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "result": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    },
    "score": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Score"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "regexp": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Regexp"
    },
    "gibberish": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Gibberish"
    },
    "disposable": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Disposable"
    },
    "webmail": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Webmail"
    },
    "mx_records": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Mx Records"
    },
    "smtp_server": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Smtp Server"
    },
    "smtp_check": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Smtp Check"
    },
    "accept_all": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Accept All"
    },
    "block": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Block"
    },
    "sources": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Sources",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "EmailVerifierOutput",
  "type": "object"
}

get_lead — Retrieve one of your leads by ID

Parameters

string

required

The unique identifier of the lead

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "first_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "First Name"
    },
    "last_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Name"
    },
    "position": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Position"
    },
    "company": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetLeadOutput",
  "type": "object"
}

get_leads_list — Retrieves all the fields of a leads list, including its leads

Parameters

string

required

Identifier of the leads list to retrieve

integer

required

A limit on the number of leads to be returned. Limit can range between 1 and 100 (Default: 100)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "leads": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Leads",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetLeadsListOutput",
  "type": "object"
}

list_leads — List all your leads with comprehensive filtering options

Parameters

string

Only returns the leads belonging to this list

string

Filter leads by email

string

Filter leads by first name

string

Filter leads by last name

string

Filter leads by position

string

Filter leads by company

string

Filter leads by industry

string

Filter leads by website

string

Filter leads by country code (ISO 3166-1 alpha-2)

string

Filter leads by company size

string

Filter leads by source

string

Filter leads by Twitter handle

string

Filter leads by LinkedIn URL

string

Filter leads by phone number

string

Filter by synchronization status. Allowed values: pending, error, success

string

Filter by sending status. Comma-separated values: clicked, opened, sent, pending, error, bounced, unsubscribed, replied

string

Filter by verification status. Comma-separated values: accept_all, disposable, invalid, unknown, valid, webmail, pending

string

Filter by last activity. Allowed values: * (any), ~ (unset)

string

Filter by last contact date. Allowed values: * (any), ~ (unset)

string

Only returns leads with First Name, Last Name, or Email matching the query

integer

required

A limit on the number of leads to be returned. Limit can range between 1 and 1000 (Default: 100)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "leads": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Leads",
      "type": "array"
    },
    "total": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListLeadsOutput",
  "type": "object"
}

list_leads_lists — List all your leads lists, sorted with the most recent first

Parameters

integer

required

A limit on the number of lists to be returned. Limit can range between 1 and 100 (Default: 100)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "leads_lists": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Leads Lists",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListLeadsListsOutput",
  "type": "object"
}

update_lead — Update an existing lead in your Hunter account

Parameters

string

required

The unique identifier of the lead

string

The email address of the lead

string

The person’s first name

string

The person’s last name

string

The person’s position in the company

string

The company name

string

The website URL of the company

string

The person’s phone number

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateLeadOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Hunter Integration for AI Agents & Workflows

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Apollo.io

Brandfetch

Clay

Links

​Overview

​Authentication

​API Key Authentication

​Required Credentials

​Available Actions

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Apollo.io

Brandfetch

Clay

​Links

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links