# Mails.so

Mails is an API service that provides powerful email validation capabilities to help maintain a clean and effective email list.

- **Category:** email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `MAILS_SO`
- **Version:** 20260211_00

## Tools

### Retrieve Batch Results

**Slug:** `MAILS_SO_RETRIEVE_BATCH_RESULTS`

Tool to retrieve results of a bulk validation job. Use after submitting a batch and you have its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier for the batch validation job |

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

**Slug:** `MAILS_SO_VALIDATE_BULK_EMAILS`

Tool to validate multiple email addresses in bulk. Use when you need to confirm deliverability of a list of emails at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | List of 1–1000 email addresses to validate |

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

**Slug:** `MAILS_SO_VALIDATE_SINGLE_EMAIL`

Tool to validate a single email address. Use when you need to check deliverability and quality details before sending an email.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address to validate. |

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