---
canonical_url: "https://docs.composio.dev/toolkits/minelead"
markdown_url: "https://docs.composio.dev/toolkits/minelead.md"
product: "platform"
version: null
last_updated: null
---

# Minelead.io

Minelead.io provides email discovery, verification, enrichment, lead management, buying-intent analysis, and campaign recipient APIs for sales workflows.

- **Category:** ai sales tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `MINELEAD`
- **Version:** 00000000_00

## Tools

### Detect Disposable Email

**Slug:** `MINELEAD_DETECT_DISPOSABLE_EMAIL`

Check an email for disposable-address, DNS, format, and spam signals. Minelead does not document this endpoint's credit cost, so callers should treat it as potentially credit-consuming. HTTP 200 application errors fail the call; only completed results are returned.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to inspect for disposable-address and DNS signals. |

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

### Enrich Email

**Slug:** `MINELEAD_ENRICH_EMAIL`

Enrich one email with professional and social profile information. Minelead charges 2 credits per request. A no-match result is returned with status `not_found`; application errors reported inside HTTP 200 responses fail the call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Full name to improve matching accuracy. |
| `email` | string | Yes | Email address to enrich. |
| `company` | string | No | Company name or domain to improve matching accuracy. |

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

**Slug:** `MINELEAD_FIND_PERSON_EMAIL`

Find a person's professional email from their name and company domain. A found result costs 1 credit; Minelead documents no charge when no email or only bouncing emails are returned. Catch-all domains return a completed no-result instead of an execution error.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Company domain without a URL scheme. |
| `last_name` | string | Yes | Person's last name; sent to Minelead as `lastname`. |
| `first_name` | string | Yes | Person's first name; sent to Minelead as `firstname`. |

#### 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 Social Profile Emails

**Slug:** `MINELEAD_FIND_SOCIAL_PROFILE_EMAILS`

Find emails associated with a YouTube channel or Twitter/X profile URL. Results may be masked and are locally capped by max_emails_to_return; the response reports truncation. Minelead charges 2 credits only when emails are found and no charge when none are found.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `profile_url` | string | Yes | Full YouTube channel or Twitter/X profile URL. |
| `max_emails_to_return` | integer | No | Local response-size cap across all domains (1-500). This does not change the Minelead request and is not pagination. |

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

### Generate Company Domains

**Slug:** `MINELEAD_GENERATE_COMPANY_DOMAINS`

Generate candidate company domains from keyword and location tags. A successful request costs 1 credit, and returned domains may be masked.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | Yes | Keywords and locations that describe the desired companies. |

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

### List Saved Leads

**Slug:** `MINELEAD_LIST_SAVED_LEADS`

List leads already saved in the connected Minelead account. Minelead documents no credit cost for this read. The verified no-leads response is returned as an empty list, while application-level errors fail the execution.

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

### List Search History

**Slug:** `MINELEAD_LIST_SEARCH_HISTORY`

Return up to 25 entries from the connected account's search history. Minelead does not document a credit cost for this read. Use the returned cursor to continue; a verified no-history response marks the end.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Continuation cursor returned by a previous call. Omit for the first page. |

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

### Search Company Emails

**Slug:** `MINELEAD_SEARCH_COMPANY_EMAILS`

Find known email addresses for a company domain. Results may include masked addresses. A successful standard search costs 1 credit; Deep Search and inline enrichment are not included.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Company domain without a URL scheme. |
| `light_mode` | boolean | No | When true, return only email addresses Minelead has already found. |
| `max_emails` | integer | No | Maximum number of email results to request (1-4). |
| `generic_only` | boolean | No | When true, request only generic or role-based email addresses. |

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

### Search Company Emails Batch

**Slug:** `MINELEAD_SEARCH_COMPANY_EMAILS_BATCH`

Search 1-8 company domains in one call and return a result for each domain. Results may include masked addresses. Each successful domain search costs 1 credit, so one batch can cost up to 8 credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domains` | array | Yes | Unique company domains without URL schemes (1-8). Each successful domain search costs 1 Minelead credit. |
| `light_mode` | boolean | No | When true, return only addresses Minelead has already found. |
| `generic_only` | boolean | No | When true, request only generic or role-based addresses for every domain. |
| `max_emails_per_domain` | integer | No | Maximum email results to request for each domain (1-4). |

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

### Validate Email

**Slug:** `MINELEAD_VALIDATE_EMAIL`

Validate an email's format, MX records, mailbox result, personal-provider status, and disposability. Minelead charges 1 credit per verification. HTTP 200 may contain an application failure; `catch-all` is a valid verification outcome and `exists` may be `unknown`.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify. |
| `last_name` | string | No | Optional last name; sent to Minelead as `lastname`. |
| `first_name` | string | No | Optional first name; sent to Minelead as `firstname`. |

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