# Icypeas AI integration on Definable

> Icypeas is an email discovery and verification tool that allows users to find and verify professional email addresses using first name, last name, and company domain.

## What this connects

Icypeas is an email discovery and verification tool that allows users to find and verify professional email addresses using first name, last name, and company domain.

Vendor: https://www.icypeas.com/

## Tools available

**22** tools available. First 12:

- `ICYPEAS_BULK_EMAIL_SEARCH` — Bulk Email Search — Initiate a bulk email search job to find professional email addresses for multiple people at once. Use this tool when you need to find emails for more than one person. Provide names (first and/or last) along with company domains or names. The API queues the job and returns a file identifier that can be used with 'Fetch Bulk Search Info' and 'Retrieve Search Results' to check progress and get results. Rate limit: 1 request per second. Maximum 5000 rows per bulk request.
- `ICYPEAS_BULK_FIND_PROFILE_URLS` — Find Profile URLs Bulk — Tool to perform bulk search for profile URLs based on firstname, lastname, and company/domain or job title. Use when you need to find LinkedIn or other social profile URLs for multiple prospects at once (up to 50 per request). This endpoint returns immediate results with profile URLs. Each result includes the found URL (or empty string if not found), a search ID, and a status indicator.
- `ICYPEAS_BULK_REVERSE_EMAIL_LOOKUP` — Bulk Reverse Email Lookup — Tool to find LinkedIn profile URLs for multiple professional email addresses in a single request. Use when you need to reverse lookup 2-50 email addresses to find their associated LinkedIn profiles. Each lookup costs 10 credits per found profile. Returns results immediately (not async like other bulk operations).
- `ICYPEAS_BULK_SCRAPE` — Scrape Bulk — Tool to scrape multiple LinkedIn profiles or companies in bulk (up to 50 per request). Use when you need to scrape multiple LinkedIn URLs at once. Returns a job ID that can be used with check_progress to fetch results.
- `ICYPEAS_CHECK_PROGRESS` — Check Search Progress — Check the processing progress of a search by its ID. Use this tool after initiating a single or bulk search to monitor its status. For mode='single': Checks progress of individual search items via /bulk-single-searchs/read endpoint. For mode='bulk': Checks progress of bulk search files via /search-files/read endpoint. Poll this endpoint periodically until 'finished' is True or item status is 'DEBITED'. Note: ICYPEAS recommends using webhooks instead of polling for production use.
- `ICYPEAS_COUNT_COMPANIES` — Count Companies — Tool to count companies in Icypeas database matching specified filters without returning data or being charged. Use when you need to know how many companies match specific criteria like industry, location, or headcount.
- `ICYPEAS_COUNT_PEOPLE` — Count People — Tool to count people matching specified filters without retrieving data or consuming credits. Use when you need to assess the size of a people search result set before running the actual query.
- `ICYPEAS_DOMAIN_SCAN` — Domain Scan — Tool to scan a domain for role-based email addresses. Use when you need to discover all role-based emails for a specific domain.
- `ICYPEAS_FETCH_BULK_SEARCH_INFO` — Fetch Bulk Search Info — Retrieve bulk search files with their status and progress. Lists all bulk searches (email, profile, company searches) with pagination support. Use to monitor bulk operation progress, check completion status, or retrieve file IDs for further operations.
- `ICYPEAS_FETCH_SUBSCRIPTION_INFO` — Fetch Subscription Information — Retrieves subscription details and remaining credits for an Icypeas account. Use this to check credit balances, subscription status, and user ID before performing searches. The email parameter must match the account owner's email associated with the API key.
- `ICYPEAS_FIND_COMPANIES` — Find Companies — Tool to search companies in Icypeas database. Use when you need to find companies matching filters like industry, location, or headcount.
- `ICYPEAS_FIND_COMPANY_URL` — Find Company URL — Tool to find a single company profile URL using a company name or domain. Use when you need to initiate a profile-URL search for a given company identifier.

## Auth

Auth schemes: `API_KEY`.

## How agents use Icypeas

Inside a Definable workflow, Icypeas is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Icypeas** — the Researcher (GPT-5.5) pulls context from Icypeas (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Icypeas** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Icypeas (create record, post message, draft email).
- **Designer / Engineer → Distributor → Icypeas** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Icypeas (attach file, open PR comment, post status).

The Verifier checks every Icypeas call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- email — https://definable.ai/apps/category/email/
- contact management — https://definable.ai/apps/category/contact-management/

## Related

- HTML page: https://definable.ai/apps/icypeas/
- Same category (email): https://definable.ai/apps/category/email/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt