# Clearout

Clearout offers AI-powered email validation, email finder, and prospecting services to enhance email deliverability and lead generation.

- **Category:** email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 21
- **Triggers:** 0
- **Slug:** `CLEAROUT`
- **Version:** 20260307_00

## Tools

### Autocomplete Company to Domain

**Slug:** `CLEAROUT_AUTOCOMPLETE_COMPANY_TO_DOMAIN`

Tool to autocomplete company names to probable domains with confidence scores. Use after obtaining a company name or URL to get suggestions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Company name, domain, or website URL to autocomplete domains. Examples: 'amazon', 'amazon.com', 'https://amazon.com/about'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Business Account Verify

**Slug:** `CLEAROUT_BUSINESS_ACCOUNT_VERIFY`

Tool to check if an email belongs to a business/work account. Use when validating corporate emails before onboarding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | An email address to verify for a business/work account |
| `timeout` | integer | No | Request wait time in milliseconds; max 110000; default 90000 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Catch-All Verify

**Slug:** `CLEAROUT_CATCH_ALL_VERIFY`

Tool to check if an email domain is catch-all. Use after confirming email validity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify for catch-all |
| `timeout` | integer | No | Timeout in milliseconds; maximum 110000; default 90000 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Disposable Email

**Slug:** `CLEAROUT_DISPOSABLE_VERIFY`

Tool to check if an email is from a disposable provider. Use after acquiring an email address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify for disposability. |
| `timeout` | integer | No | Request wait time in milliseconds; maximum 110000; default is 90000 if omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Domain MX Records

**Slug:** `CLEAROUT_DOMAIN_FIND_MX`

Tool to retrieve MX records for a domain in priority order. Use when you need to find a domain's mail servers (e.g., for email routing setup).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Domain to resolve MX records for |
| `timeout` | integer | No | Maximum wait time for MX resolution in milliseconds (default 90000, max 110000) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Fetch Domain WHOIS Information

**Slug:** `CLEAROUT_DOMAIN_FIND_WHOIS`

Tool to fetch WHOIS record for a domain. Use when you need WHOIS data for a domain.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Domain to fetch WHOIS information for, must be a non-empty string. |
| `timeout` | integer | No | Wait time in milliseconds (max 110000; default 90000). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Email Finder

**Slug:** `CLEAROUT_EMAIL_FINDER_BULK`

Tool to upload a CSV or XLSX contacts file for bulk email finding. Use when you need to find emails for a list of contacts in bulk.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | No | Contacts file to upload for bulk email finding. Supported extensions:.csv,.xlsx. The CSV/XLSX file must contain columns for person's name and company domain or company name. |
| `file_name` | string | No | Name of the file when using file_path variant. Defaults to basename of file_path. |
| `file_path` | string | No | Absolute path to a local file to upload when FileUploadable is not available. Use either 'file' or 'file_path', not both. |
| `file_mimetype` | string | No | MIME type of the file when using file_path variant. Defaults to 'text/csv'. |
| `ignore_duplicate_file` | string ("true" | "false") | No | Whether to allow uploading a file with the same name and size as a recent upload. Defaults to 'false'. Set to 'true' to override duplicates. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Bulk Email Finder Job

**Slug:** `CLEAROUT_EMAIL_FINDER_BULK_CANCEL`

Tool to cancel a running bulk email finder job. Use when you need to stop an in-progress list scan before completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The unique 24-character hexadecimal identifier for the bulk email finder job to cancel. This ID is returned when you create a bulk email finder job using the EMAIL_FINDER_BULK action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Email Finder Result Download

**Slug:** `CLEAROUT_EMAIL_FINDER_BULK_RESULT_DOWNLOAD`

Tool to generate a bulk email finder result download URL. Use after confirming bulk job completion to retrieve the result file link.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The List ID returned by the bulk email finder response used to retrieve the result file. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Email Verify

**Slug:** `CLEAROUT_EMAIL_VERIFY_BULK`

Tool to upload a CSV or XLSX file for bulk email verification. Use when you have a list of emails to verify in bulk.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | No | Email list file to verify in bulk. Supported extensions: .csv, .xlsx. |
| `optimize` | string ("highest_accuracy" | "fastest_turnaround") | No | Optimization mode for bulk verification. 'highest_accuracy' prioritizes precision; 'fastest_turnaround' prioritizes speed. Defaults to 'highest_accuracy'. |
| `file_name` | string | No | Name of the file when using file_path variant. |
| `file_path` | string | No | Absolute path to a local file to upload. |
| `file_mimetype` | string | No | MIME type of the file when using file_path variant. |
| `ignore_duplicate_file` | string ("true" | "false") | No | Whether to allow uploading a file that matches a recent upload (same name & size). Defaults to 'false'. Set to 'true' to override duplicates. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Bulk Email Verification Job

**Slug:** `CLEAROUT_EMAIL_VERIFY_BULK_CANCEL`

Cancel an in-progress bulk email verification job. Use this to stop a running verification before it completes, saving credits for unprocessed emails. The job must be in a cancellable state (not already completed or cancelled). Returns error code 1029 if list doesn't exist, or error code 1116 if the list is not in a cancellable stage.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The 24-character MongoDB ObjectId (hex string) for the bulk email verification job to cancel. Obtain this from the response of the EMAIL_VERIFY_BULK action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Email Verify Progress Status

**Slug:** `CLEAROUT_EMAIL_VERIFY_BULK_PROGRESS_STATUS`

Tool to retrieve progress for a bulk email verification job. Use after initiating a bulk verification to poll its state and percent complete.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | Identifier of the bulk email verification job returned by the bulk upload endpoint |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Email Verify Result Download

**Slug:** `CLEAROUT_EMAIL_VERIFY_BULK_RESULT_DOWNLOAD`

Tool to obtain a temporary URL for bulk email verification results. Use after completing a bulk verification job to download the results file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The unique identifier (24-character hex string) of a bulk email verification list, returned by the CLEAROUT_EMAIL_VERIFY_BULK action. The verification job must be completed before downloading results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email Verify Get Credits

**Slug:** `CLEAROUT_EMAIL_VERIFY_GET_CREDITS`

Tool to fetch available email verification credits. Use when checking remaining credits before performing email verifications.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Instant Email Verifier

**Slug:** `CLEAROUT_EMAIL_VERIFY_INSTANT`

Tool to instantly verify a single email address. Use when you need real-time validation before processing an email.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify. |
| `timeout` | integer | No | Request wait time in milliseconds; default is 130000, max is 180000. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Free Email Account

**Slug:** `CLEAROUT_FREE_ACCOUNT_VERIFY`

Tool to detect if an email is from a free email service provider. Use after confirming the email format.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | An email address to verify for a free email service provider |
| `timeout` | integer | No | Request wait time in milliseconds; max 110000; default 90000 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Gibberish Email

**Slug:** `CLEAROUT_GIBBERISH_ACCOUNT_VERIFY`

Tool to verify if an email address is gibberish. Use when filtering out nonsensical or invalid-looking emails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify for gibberish. |
| `timeout` | integer | No | Request wait time in milliseconds; default is 90000; maximum is 110000. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reverse Lookup Company by Domain

**Slug:** `CLEAROUT_REVERSE_LOOKUP_FIND_COMPANY_VIA_DOMAIN`

Find company information (name, logo, LinkedIn URL, address) by looking up its domain name. Returns company profile data if found, or an error with code 5025 if no profile exists for the domain.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The company's domain name (e.g., 'amazon.com', 'microsoft.com'). Do not include 'https://' or 'www.' prefix - just the bare domain. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reverse Lookup Person by Email

**Slug:** `CLEAROUT_REVERSE_LOOKUP_FIND_PERSON_VIA_EMAIL`

Tool to retrieve a person’s profile from an email address. Use when you want to enrich a valid email with associated person details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email_address` | string | Yes | Email address to look up the person profile |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Person via LinkedIn URL

**Slug:** `CLEAROUT_REVERSE_LOOKUP_FIND_PERSON_VIA_LINKED_IN`

Tool to discover person information via a LinkedIn profile URL. Use when you need to retrieve person’s profile details from a LinkedIn URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | LinkedIn profile URL of the person (e.g., https://www.linkedin.com/in/williamhgates/). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Role Account Verifier

**Slug:** `CLEAROUT_ROLE_ACCOUNT_VERIFY`

Tool to determine if an email is a role-based account. Use when identifying group mailboxes (e.g., support@) before sending targeted communications.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify (e.g., support@company.com). |
| `timeout` | integer | No | Optional timeout in milliseconds; default is 90000, max is 110000. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |