Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 43 additions & 0 deletions apps/docs/components/icons.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -2283,6 +2283,49 @@ export function ElevenLabsIcon(props: SVGProps<SVGSVGElement>) {
)
}

export function FindymailIcon(props: SVGProps<SVGSVGElement>) {
return (
<svg {...props} xmlns='http://www.w3.org/2000/svg' viewBox='0 0 45.4462 31.2952' fill='none'>
<path
fillRule='evenodd'
clipRule='evenodd'
d='M27.7788 8.18066C26.628 8.18066 25.479 8.62026 24.6016 9.49766L22.7235 11.0666L20.8454 9.49766C19.968 8.62026 18.8189 8.18066 17.6681 8.18066C16.5191 8.18066 15.3683 8.62026 14.4909 9.49766C12.7361 11.2525 12.7361 14.0991 14.4909 15.8521L20.9722 22.0922C21.9497 23.0339 23.4972 23.0339 24.4747 22.0922L30.9578 15.8521C32.7126 14.0991 32.7126 11.2525 30.9578 9.49766C30.0804 8.62026 28.9296 8.18066 27.7788 8.18066Z'
fill='url(#findymail_paint0)'
/>
<path
fillRule='evenodd'
clipRule='evenodd'
d='M42.3815 27.2995C42.3815 27.8571 41.9312 28.3074 41.3737 28.3074H4.0725C3.51497 28.3074 3.06644 27.8571 3.06644 27.2995V7.29083C3.06644 6.39914 4.1279 5.9381 4.77835 6.54745L9.53884 11.0042C9.95341 11.3937 10.6182 11.1971 10.7718 10.6485C10.8791 10.2715 11.0167 9.90338 11.1846 9.54956C11.4062 9.08138 11.2579 8.51848 10.8791 8.16466L7.1854 4.70509C6.52958 4.09037 6.96382 2.9896 7.86445 2.9896H37.58C38.4806 2.9896 38.9166 4.09216 38.259 4.70688L34.5671 8.16109C34.1901 8.51491 34.04 9.07959 34.2633 9.54777C34.4295 9.90159 34.5671 10.2679 34.6743 10.645C34.828 11.1918 35.4928 11.3884 35.9073 11.0006L40.6678 6.54567C41.3183 5.93631 42.3815 6.39735 42.3815 7.28726V27.2995ZM42.9141 0H2.53213C1.13294 0 0 1.13294 0 2.53213V28.7631C0 30.1622 1.13294 31.2952 2.53213 31.2952H42.9141C44.3132 31.2952 45.4462 30.1622 45.4462 28.7631V2.53213C45.4462 1.13294 44.3132 0 42.9141 0Z'
fill='url(#findymail_paint1)'
/>
<defs>
<linearGradient
id='findymail_paint0'
x1='20.5769'
y1='8.68821'
x2='24.6922'
y2='23.0919'
gradientUnits='userSpaceOnUse'
>
<stop stopColor='#F04249' />
<stop offset='0.289072' stopColor='#DE2337' />
<stop offset='1' stopColor='#B91C1C' />
</linearGradient>
<linearGradient
id='findymail_paint1'
x1='22.7231'
y1='0'
x2='22.7231'
y2='31.2952'
gradientUnits='userSpaceOnUse'
>
<stop stopColor='#18181B' />
<stop offset='1' />
</linearGradient>
</defs>
</svg>
)
}
export function FathomIcon(props: SVGProps<SVGSVGElement>) {
return (
<svg {...props} xmlns='http://www.w3.org/2000/svg' viewBox='0 0 1000 1000' fill='none'>
Expand Down
3 changes: 3 additions & 0 deletions apps/docs/components/ui/icon-mapping.ts
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@ import {
ExtendIcon,
EyeIcon,
FathomIcon,
FindymailIcon,
FirecrawlIcon,
FirefliesIcon,
GammaIcon,
Expand Down Expand Up @@ -262,7 +263,9 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
extend_v2: ExtendIcon,
fathom: FathomIcon,
file: DocumentIcon,
file_v3: DocumentIcon,
file_v4: DocumentIcon,
Comment thread
waleedlatif1 marked this conversation as resolved.
findymail: FindymailIcon,
firecrawl: FirecrawlIcon,
fireflies: FirefliesIcon,
fireflies_v2: FirefliesIcon,
Expand Down
286 changes: 286 additions & 0 deletions apps/docs/content/docs/en/tools/findymail.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,286 @@
---
title: Findymail
description: Find and verify B2B emails, phones, employees, and company data
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard
type="findymail"
color="#FFFFFF"
/>

{/* MANUAL-CONTENT-START:intro */}
[Findymail](https://findymail.com/) is a B2B contact data platform for finding and verifying work emails, phone numbers, and enriched profile data on company employees. It combines real-time email finding, deliverability verification, reverse-lookup, and technology stack detection in a single API.

With Findymail, you can:

- **Find work emails by name and company:** Resolve a verified work email from a person's name plus a company domain or company name.
- **Find emails from LinkedIn:** Look up the verified work email behind any LinkedIn profile URL.
- **Find contacts by role:** Search a company domain for verified emails matching specific target roles (e.g., CEO, Founder).
- **Verify deliverability:** Check whether an email is deliverable and identify the underlying mail provider.
- **Reverse-lookup profiles:** Given an email, return the matching LinkedIn URL and an optional enriched profile (job, education, skills, certificates).
- **Enrich companies and employees:** Look up company metadata by LinkedIn URL, domain, or name, and find employees by website and target job titles.
- **Find phone numbers:** Retrieve a contact's phone number (US-only) from a LinkedIn profile URL.
- **Detect technology stacks:** Search the technology catalog or look up the full tech stack of a company by domain.

In Sim, the Findymail integration lets your agents programmatically build verified contact lists, enrich CRMs, qualify leads, and gather technographic data without leaving your workflow. Use it to automate outbound prospecting, augment incoming form submissions, validate email captures before sending, and trigger downstream actions when a verified contact is found.
{/* MANUAL-CONTENT-END */}


## 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.



## Tools

### `findymail_verify_email`

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

#### Input

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

#### 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\) |

### `findymail_find_email_from_name`

Find someone

#### Input

| 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

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `contact` | object | Contact information |
| ↳ `name` | string | Contact full name |
| ↳ `email` | string | Contact email address |
| ↳ `domain` | string | Email 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.

#### Input

| 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"\]\) |
| `items` | string | No | No description |
| `apiKey` | string | Yes | Findymail API Key |

#### Output

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

### `findymail_find_email_from_linkedin`

Find someone

#### Input

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

#### Output

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

### `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.

#### Input

| 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

| 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\) |

### `findymail_get_company`

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

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `linkedin_url` | string | No | Company LinkedIn URL \(e.g., 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

| 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 |

### `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.

#### Input

| 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"\]\) |
| `items` | string | No | No description |
| `count` | number | No | Number of contacts to return \(max 5, default 1\) |
| `apiKey` | string | Yes | Findymail API Key |

#### Output

| 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 |

### `findymail_find_phone`

Find someone

#### Input

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

#### Output

| 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"\) |

### `findymail_search_technologies`

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

#### Input

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

#### Output

| 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\) |

### `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.

#### Input

| 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"\]\) |
| `items` | string | No | No description |
| `apiKey` | string | Yes | Findymail API Key |

#### Output

| 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 |

### `findymail_get_credits`

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

#### Input

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

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `credits` | number | Remaining finder credits |
| `verifier_credits` | number | Remaining verifier credits |


1 change: 1 addition & 0 deletions apps/docs/content/docs/en/tools/meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@
"extend",
"fathom",
"file",
"findymail",
"firecrawl",
"fireflies",
"gamma",
Expand Down
2 changes: 2 additions & 0 deletions apps/sim/app/(landing)/integrations/data/icon-mapping.ts
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@ import {
ExtendIcon,
EyeIcon,
FathomIcon,
FindymailIcon,
FirecrawlIcon,
FirefliesIcon,
GammaIcon,
Expand Down Expand Up @@ -259,6 +260,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
extend_v2: ExtendIcon,
fathom: FathomIcon,
file_v4: DocumentIcon,
findymail: FindymailIcon,
firecrawl: FirecrawlIcon,
fireflies_v2: FirefliesIcon,
gamma: GammaIcon,
Expand Down
Loading
Loading