CONNECT APP
Build with Hunter
CRM
- API key
MCP
Give your agent Hunter tools
Every Hunter action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Hunter account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "hunter",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// e.g. run Account Information:
const result = await mcp.callTool({
name: "hunter-account-information",
arguments: {},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", # any stable ID for this user in your system
"x-pd-app-slug": "hunter",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Account Information:
result = await session.call_tool("hunter-account-information", {})API PROXY
Call the Hunter API directly
For an endpoint with no pre-built tool, the Connect proxy forwards your request to the Hunter API with the connected user's credentials attached. You store no tokens and write no refresh logic.
const resp = await pd.proxy.get({
externalUserId: "{external_user_id}", // any stable ID for this user in your system
accountId: "apn_xxxxxxx",
url: "https://api.hunter.io/v2/domain-search",
})
// Any allowed Hunter endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.# The path segment is the target URL, URL-safe base64 encoded:
# https://api.hunter.io/v2/domain-search
curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuaHVudGVyLmlvL3YyL2RvbWFpbi1zZWFyY2g?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
-H "Authorization: Bearer {access_token}" \
-H "x-pd-environment: production"SDK
Run Hunter actions from your backend
Connect a user's Hunter account once, then run Account Information on their behalf from your own code — TypeScript, Python, or plain HTTP.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "hunter-account-information",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
hunter: { authProvisionId: "apn_xxxxxxx" },
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="hunter-account-information",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"hunter": {"authProvisionId": "apn_xxxxxxx"},
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "hunter-account-information",
"configured_props": {
"hunter": { "authProvisionId": "apn_xxxxxxx" }
}
}'TOOLS
Hunter actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Account Information
actionGet information about your Hunter account. See the documentation.Read-onlyv0.0.2 -
Combined Enrichment
actionReturns all the information associated with an email address and its domain name. See the documentation.Writev0.0.2 -
Create Lead
actionCreate a new lead in your Hunter account. See the documentation.Writev0.0.2 -
Delete Lead
actionDelete an existing lead from your Hunter account. See the documentation.Writev0.0.2 -
Domain Search
actionSearch all the email addresses corresponding to one website or company. See the documentation.Read-onlyv0.0.2 -
Email Count
actionGet the number of email addresses Hunter has for one domain or company. See the documentation.Read-onlyv0.0.2 -
Email Finder
actionFind the most likely email address from a domain name, a first name and a last name. See the documentation.Read-onlyv0.0.2 -
Email Verifier
actionCheck the deliverability of a given email address, verify if it has been found in Hunter's database, and return their sources. See the documentation.Read-onlyv0.0.2 -
Get Lead
actionRetrieve one of your leads by ID. See the documentation.Read-onlyv0.0.2 -
Get Leads List
actionRetrieves all the fields of a leads list, including its leads. See the documentation.Read-onlyv0.0.2 -
List Leads
actionList all your leads with comprehensive filtering options. The leads are returned in sorted order, with the most recent leads appearing first. See the documentation.Read-onlyv0.0.3 -
List Leads Lists
actionList all your leads lists. The leads lists are returned in sorted order, with the most recent leads lists appearing first. See the documentation.Read-onlyv0.0.2 -
Update Lead
actionUpdate an existing lead in your Hunter account. See the documentation.Writev0.0.2
No Hunter triggers are available yet.
MULTI-APP
Use Hunter with other popular apps
Most products don't stop at one integration. Pair Hunter with the other apps your users rely on, and ship use cases that span both.
- App slug
- hunter
- Authentication
- API key
- Categories
- CRM
- Actions
- 13
- Triggers
- 0
- API proxy
- Available