# Findymail (/integrations/findymail)





{/* MANUAL-CONTENT-START:intro */}

Use [Findymail](https://findymail.com/) to find work emails by name and company or LinkedIn URL, search a company's contacts by role, and verify email deliverability. The actions also reverse-lookup a profile from an email, enrich companies and employees, look up phone numbers from LinkedIn profiles, and search technology stacks.

Phone-number lookup is limited to US contacts. Inspect verification and match results before using the returned contact details in later steps.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Integrate Findymail to find verified work emails by name, domain, or LinkedIn URL, verify deliverability, reverse-lookup profiles from emails, enrich company data, find employees by job title, look up phone numbers, search technology stacks, and check credit usage.

## Actions [#actions]

### Findymail Verify Email [#findymail-verify-email]

Verifies the deliverability of an email address. Uses one verifier credit.

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `email` | string | Yes | Email address to verify (e.g., [john@example.com](mailto:john@example.com)) |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `email` | string | The verified email address |
  | `verified` | boolean | Whether the email is verified as deliverable |
  | `provider` | string | Email service provider (e.g., Google, Microsoft) |
</ReferenceDetails>

### Findymail Find Email From Name [#findymail-find-email-from-name]

Find someone's email from their name and a company domain or company name. Uses one finder credit when a verified email is found.

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `name` | string | Yes | Person's full name (e.g., 'John Doe') |
  | `domain` | string | Yes | Company domain (preferred) or company name (e.g., stripe.com) |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `contact` | object | Contact information |
  | ↳ `name` | string | Contact full name |
  | ↳ `email` | string | Contact email address |
  | ↳ `domain` | string | Email domain |
</ReferenceDetails>

### Findymail Find Emails By Domain [#findymail-find-emails-by-domain]

Find verified contacts at a given domain matching one or more target roles (max 3 roles). Limited to 5 concurrent synchronous requests.

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `domain` | string | Yes | Company domain (e.g., stripe.com) |
  | `roles` | array | Yes | Target roles at the company (max 3, e.g., \["CEO", "Founder"]) |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `contacts` | array | List of contacts found |
  | ↳ `name` | string | Contact full name |
  | ↳ `email` | string | Contact email address |
  | ↳ `domain` | string | Email domain |
</ReferenceDetails>

### Findymail Find Email From LinkedIn [#findymail-find-email-from-linkedin]

Find someone's email from a LinkedIn profile URL or username. Uses one finder credit when a verified email is found.

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `linkedin_url` | string | Yes | Person's LinkedIn URL or username (e.g., '[https://linkedin.com/in/johndoe](https://linkedin.com/in/johndoe)' or 'johndoe') |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `contact` | object | Contact information |
  | ↳ `name` | string | Contact full name |
  | ↳ `email` | string | Contact email address |
  | ↳ `domain` | string | Email domain |
</ReferenceDetails>

### Findymail Reverse Email Lookup [#findymail-reverse-email-lookup]

Find a business profile from an email address. Uses 1 finder credit if a profile is found, 2 credits if returning full profile data.

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `email` | string | Yes | Work or personal email address to look up |
  | `with_profile` | boolean | No | Whether to return enriched profile metadata (default: false) |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `email` | string | The email address that was looked up |
  | `linkedin_url` | string | LinkedIn profile URL |
  | `fullName` | string | Full name from profile |
  | `username` | string | LinkedIn username |
  | `headline` | string | Profile headline |
  | `jobTitle` | string | Current job title |
  | `summary` | string | Profile summary |
  | `city` | string | City |
  | `region` | string | Region or state |
  | `country` | string | Country |
  | `companyLinkedinUrl` | string | Current company LinkedIn URL |
  | `companyName` | string | Current company name |
  | `companyWebsite` | string | Current company website |
  | `isPremium` | boolean | Whether the profile has LinkedIn Premium |
  | `isOpenProfile` | boolean | Whether the profile is an Open Profile |
  | `skills` | array | List of profile skills |
  | `jobs` | array | Job history entries |
  | `educations` | array | Education history (school, degree, fieldOfStudy, startDate, endDate) |
  | `certificates` | array | Certifications (name, issuingOrganization, issueDate, expirationDate) |
</ReferenceDetails>

### Findymail Get Company [#findymail-get-company]

Retrieve company information from a LinkedIn URL, domain, or company name. Uses 1 finder credit per successful response.

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `linkedin_url` | string | No | Company LinkedIn URL (e.g., [https://www.linkedin.com/company/stripe/](https://www.linkedin.com/company/stripe/)) |
  | `domain` | string | No | Company domain (e.g., stripe.com) |
  | `name` | string | No | Company name (e.g., Stripe) |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `name` | string | Company name |
  | `domain` | string | Company domain |
  | `company_size` | string | Employee headcount range (e.g., 1001-5000) |
  | `industry` | string | Industry classification |
  | `linkedin_url` | string | Company LinkedIn URL |
  | `description` | string | Company description |
</ReferenceDetails>

### Findymail Find Employees [#findymail-find-employees]

Find employees at a company by website and target job titles. Uses 1 credit per found contact. Does not return email addresses.

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `website` | string | Yes | Company website or domain (e.g., google.com) |
  | `job_titles` | array | Yes | Target job titles to search for (max 10, e.g., \["Software Engineer", "CEO"]) |
  | `count` | number | No | Number of contacts to return (max 5, default 1) |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `employees` | array | List of employees matching the search criteria |
  | ↳ `name` | string | Employee full name |
  | ↳ `linkedinUrl` | string | LinkedIn profile URL |
  | ↳ `companyWebsite` | string | Company website |
  | ↳ `companyName` | string | Company name |
  | ↳ `jobTitle` | string | Job title |
</ReferenceDetails>

### Findymail Find Phone [#findymail-find-phone]

Find someone's phone number from a LinkedIn profile URL. Uses 10 finder credits if a phone is found. EU citizens are excluded for legal reasons.

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `linkedin_url` | string | Yes | Person's LinkedIn URL or username (e.g., '[https://linkedin.com/in/johndoe](https://linkedin.com/in/johndoe)' or 'johndoe') |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `phone` | string | Phone number in E.164 format. Only available for US numbers. |
  | `line_type` | string | Phone line type (e.g., "Mobile", "Landline") |
</ReferenceDetails>

### Findymail Search Technologies [#findymail-search-technologies]

Search the technology catalog by name. Returns up to 25 technologies. Free endpoint, rate limited to 10 requests per minute.

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `q` | string | Yes | Search term (min 2 characters, e.g., "React") |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `technologies` | array | List of technologies |
  | ↳ `name` | string | Technology name |
  | ↳ `category` | string | Technology category |
  | ↳ `subcategory` | string | Technology subcategory |
  | ↳ `last_detected_at` | string | Last detection timestamp (ISO 8601) |
</ReferenceDetails>

### Findymail Lookup Technologies [#findymail-lookup-technologies]

Get the technology stack for a company by domain. Optionally filter by technology names. 1 finder credit if technologies are found, free otherwise.

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `domain` | string | Yes | Company domain to look up (e.g., stripe.com) |
  | `technologies` | array | No | Filter by technology names, case-insensitive (e.g., \["React", "TypeScript"]) |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `technologies` | array | List of technologies |
  | ↳ `name` | string | Technology name |
  | ↳ `category` | string | Technology category |
  | ↳ `subcategory` | string | Technology subcategory |
  | ↳ `last_detected_at` | string | Last detection timestamp (ISO 8601) |
  | `domain` | string | The resolved company domain |
</ReferenceDetails>

### Findymail Get Credits [#findymail-get-credits]

Retrieve the remaining finder and verifier credits for the authenticated account.

<ReferenceDetails>
  #### Input [#input-10]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Findymail API Key |

  #### Output [#output-10]

  | Parameter | Type | Description |
  | - | - | - |
  | `credits` | number | Remaining finder credits |
  | `verifier_credits` | number | Remaining verifier credits |
</ReferenceDetails>
