# Findymail

> Find and verify B2B work emails, look up a company's employees, and read your saved contacts with Findymail.

App · Contact Management · 6 actions. Web page: https://docs.lodol.com/docs/integrations/findymail

## Actions

### Find email

Find someone's verified work email from their full name and their company. Uses one finder credit only when an email is found.

**Inputs**

- Full name (`name`, text, required): The person's full name, e.g. 'John Doe'.
- Company (`domain`, text, required): The company's website domain, e.g. 'stripe.com'. A company name also works, but a domain matches best.

**Outputs**

- `domain` (text): The company domain matched
- `email` (text): The verified work email, or empty when not found
- `found` (true/false): Whether a verified email was found
- `name` (text): The person's full name

**Example output**

```json
{
  "domain": "stripe.com",
  "email": "john@stripe.com",
  "found": true,
  "name": "John Doe"
}
```

### Find email from LinkedIn

Find someone's verified work email from their LinkedIn profile URL. Uses one finder credit only when an email is found.

**Inputs**

- LinkedIn profile URL (`linkedin_url`, text, required): The person's LinkedIn profile, e.g. 'https://www.linkedin.com/in/johndoe'. The username alone ('johndoe') also works.

**Outputs**

- `domain` (text): The company domain matched
- `email` (text): The verified work email, or empty when not found
- `found` (true/false): Whether a verified email was found
- `name` (text): The person's full name

**Example output**

```json
{
  "domain": "stripe.com",
  "email": "john@stripe.com",
  "found": true,
  "name": "John Doe"
}
```

### Find employees

Find people at a company whose job title matches one you give. Returns their LinkedIn profile, which you can pass to Find email from LinkedIn to reveal an email. Uses one finder credit per person found.

**Inputs**

- Company website (`website`, text, required): The company's website domain, e.g. 'stripe.com'.
- Job titles (`job_titles`, list, required): Job titles to match, e.g. 'Head of Sales', 'CEO'. Up to 10; a person matching any of them can be returned.
- Number of people (`count`, number): How many people to return (1-5). From 1 to 5. Default: `1`.

**Outputs**

- `employees` (list): The people found, without emails
- `total_count` (number): How many people were returned

**Example output**

```json
{
  "employees": [
    {
      "company_name": "Findymail",
      "company_website": "https://www.findymail.com",
      "job_title": "Software Engineer",
      "linkedin_url": "https://www.linkedin.com/in/john-doe/",
      "name": "John Doe"
    }
  ],
  "total_count": 1
}
```

### Get company info

Look up a company's size, industry, description, and LinkedIn page from its domain, name, or LinkedIn URL. Uses one finder credit only when the company is found.

**Inputs**

- Company domain (`domain`, text): The company's website domain, e.g. 'stripe.com'. Matches best.
- Company name (`name`, text): Optional. The company's name, e.g. 'Stripe'.
- Company LinkedIn URL (`linkedin_url`, text): Optional. The company's LinkedIn page, e.g. 'https://www.linkedin.com/company/stripe/'.

**Outputs**

- `company_size` (text): Employee count range, e.g. '1001-5000'
- `description` (text): Company description
- `domain` (text): Website domain
- `found` (true/false): Whether a matching company was found
- `industry` (text): Industry
- `linkedin_url` (text): Company LinkedIn page
- `name` (text): Company name

**Example output**

```json
{
  "company_size": "1001-5000",
  "description": "Stripe is a technology company...",
  "domain": "stripe.com",
  "found": true,
  "industry": "Financial Services",
  "linkedin_url": "https://www.linkedin.com/company/stripe/",
  "name": "Stripe"
}
```

### List saved contacts

Read the contacts saved in your Findymail account, either from one contact list or across all of them. Free: uses no credits.

**Inputs**

- Contact list (`list_id`, number): The contact list to read. Defaults to All contacts, which returns every saved contact. Default: `0`.

**Outputs**

- `contacts` (list): The saved contacts
- `total_count` (number): How many contacts were returned

**Example output**

```json
{
  "contacts": [
    {
      "company": "MyCompany",
      "email": "john@company.com",
      "id": 1,
      "job_title": "CEO",
      "linkedin_url": "https://www.linkedin.com/in/johndoe",
      "name": "John Doe"
    }
  ],
  "total_count": 1
}
```

### Verify email

Check whether an email address is deliverable before sending to it. Uses one verifier credit per check.

**Inputs**

- Email (`email`, text, required): The email address to verify.

**Outputs**

- `email` (text): The email address that was checked
- `provider` (text): The mailbox provider, e.g. 'Google'
- `verified` (true/false): Whether the address is deliverable

**Example output**

```json
{
  "email": "john@stripe.com",
  "provider": "Google",
  "verified": true
}
```