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

# MailboxValidator

MailboxValidator checks email addresses for syntax, deliverability, mail-server availability, and free or disposable provider status.

- **Category:** email
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `MAILBOXVALIDATOR`
- **Version:** 00000000_00

## Tools

### Check Disposable Email

**Slug:** `MAILBOXVALIDATOR_CHECK_DISPOSABLE_EMAIL`

Check whether one email address uses a disposable email provider. Consumes one API credit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to check for a disposable provider. |

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

### Check Free Email

**Slug:** `MAILBOXVALIDATOR_CHECK_FREE_EMAIL`

Check whether one email address uses a free email provider. Consumes one API credit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to check for a free provider. |

#### 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:** `MAILBOXVALIDATOR_VALIDATE_EMAIL`

Run comprehensive syntax, domain, mail-server, reputation, and provider checks on one email address. The status field is the overall validation verdict; an HTTP success alone does not mean the mailbox was verified. Consumes one API credit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to validate. Yahoo email validation is currently unsupported by MailboxValidator. |

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