Skip to content

Repository files navigation

Hunter

Hunter app for Attio, built with the App SDK.

Overview

Hunter.io finds and verifies professional email addresses. This app exposes Hunter's Email Finder, Email Verifier, and Domain Search to Attio workflows.

Features

  • Find email workflow step — looks up the most likely email address for a person from a company domain or name plus their name, or from a LinkedIn URL alone. Branches on Email found (which outputs the address) or Email not found.
  • Verify email workflow step — verifies an email address and returns its status, score, and flags so later steps can branch or threshold.
  • Domain search workflow step — finds email addresses associated with a company domain or name, with optional filters for type, seniority, and department. Returns up to the configured limit (default 10, max 100) in a single request. Branches on Emails found (array of email + person metadata) or Emails not found.

Folder structure

Entry points are discovered by path under src/app/ — there is no central registration file.

Path Description
src/app/blocks/find-email The find-email workflow step block
src/app/blocks/verify-email The verify-email workflow step block
src/app/blocks/domain-search The domain-search workflow step block
src/hunter Hunter.io API client — semantic errors, authenticated fetch wrapper, Zod-validated endpoints
src/__mocks__ Vitest stubs for SDK modules with no runtime export

Setup

Connect Hunter at the workspace level with an API key from your Hunter API keys page.

Email Finder costs one credit per call that returns an address; calls that find nothing are not charged. Email Verifier costs one credit per verification. Domain Search costs one credit per 1–10 email addresses returned.

Development

pnpm install      # install dependencies
pnpm run dev      # run the app in dev mode
pnpm run lint     # lint
pnpm run test     # run tests

See AGENTS.md for architecture and coding guidelines.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages