# Icypeas

> Automate Icypeas: find professional email addresses, verify deliverability, and scan a company's domain for role-based addresses with an API key.

App · Contact Management · 4 actions. Web page: https://docs.lodol.com/docs/integrations/icypeas

## Actions

### Find email

Launch an Icypeas Email Finder search for one person using their name and their employer's domain or company name. This starts an asynchronous search and returns a search id. Use 'Get results' with that id to read the found email once the search has finished.

**Inputs**

- Domain or company (`domain_or_company`, text, required): The person's employer, given as a domain (e.g. icypeas.com) or a company name (e.g. Icypeas)
- Firstname (`firstname`, text): First name of the person. Required unless a last name is provided.
- Lastname (`lastname`, text): Last name of the person. Required unless a first name is provided.
- Webhook URL (`webhook_url`, text): Optional URL Icypeas will POST the result to when the search finishes
- External ID (`external_id`, text): Optional tag echoed back on the result so you can correlate it with your own records

**Outputs**: None.

**Example output**

```json
{
  "item": {
    "_id": "",
    "status": ""
  },
  "success": true
}
```

### Get results

Read the results of a previously launched Icypeas search (email finder, email verifier, or domain scan) by its search id. Because searches run asynchronously, the result may still be pending; run this again if the search has not finished.

**Inputs**

- Search ID (`search_id`, text, required): The search id returned by Find email, Verify email, or Scan domain

**Outputs**: None.

**Example output**

```json
{
  "items": [],
  "success": true
}
```

### Scan domain

Launch an Icypeas Domain Scan to discover role-based email addresses at a company (for example contact@ or support@). This starts an asynchronous search and returns a search id. Use 'Get results' with that id to read the discovered addresses once the scan has finished.

**Inputs**

- Domain or company (`domain_or_company`, text, required): The company to scan, given as a domain (e.g. icypeas.com) or a company name (e.g. Icypeas)
- Webhook URL (`webhook_url`, text): Optional URL Icypeas will POST the result to when the scan finishes
- External ID (`external_id`, text): Optional tag echoed back on the result so you can correlate it with your own records

**Outputs**: None.

**Example output**

```json
{
  "item": {
    "_id": "",
    "status": ""
  },
  "success": true
}
```

### Verify email

Launch an Icypeas Email Verifier search to check whether an email address is valid and deliverable. This starts an asynchronous search and returns a search id. Use 'Get results' with that id to read the verdict once the search has finished.

**Inputs**

- Email (`email`, text, required): The email address to verify
- Webhook URL (`webhook_url`, text): Optional URL Icypeas will POST the result to when the search finishes
- External ID (`external_id`, text): Optional tag echoed back on the result so you can correlate it with your own records

**Outputs**: None.

**Example output**

```json
{
  "item": {
    "_id": "",
    "status": ""
  },
  "success": true
}
```