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

# MailerCheck

MailerCheck verifies individual email addresses and email lists, reports verification results, and tracks account credit balances.

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

## Tools

### Create Verification List

**Slug:** `MAILERCHECK_CREATE_VERIFICATION_LIST`

Create a MailerCheck verification list by ingesting a name and email-address array. Creating a one-address list did not reduce the account credit balance during live probing. This action does not invoke the separate, credit-consuming Start List Verification operation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Human-readable name for the new verification list. |
| `emails` | array | Yes | One or more valid email addresses to ingest. MailerCheck does not document a maximum list size or how duplicate addresses are handled. |

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

### Delete Verification List

**Slug:** `MAILERCHECK_DELETE_VERIFICATION_LIST`

Permanently and irreversibly delete a MailerCheck verification list by ID. Use only when the caller explicitly intends to remove the list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | ID of the verification list to permanently delete. Verify the ID before calling because deletion is irreversible. |

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

### Get Credit Balance

**Slug:** `MAILERCHECK_GET_CREDIT_BALANCE`

Return the current MailerCheck verification-credit balance. Use this before VERIFY_EMAIL or START_LIST_VERIFICATION when cost matters.

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

### Get Current Account

**Slug:** `MAILERCHECK_GET_CURRENT_ACCOUNT`

Return the connected MailerCheck user and account identity. Use this to confirm which user and account the API token represents.

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

### Get Verification List

**Slug:** `MAILERCHECK_GET_VERIFICATION_LIST`

Return one verification list, including its status, item count, verification timing, and aggregate result statistics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Verification-list ID returned by CREATE_VERIFICATION_LIST or LIST_VERIFICATION_LISTS. |

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

**Slug:** `MAILERCHECK_LIST_VERIFICATION_LISTS`

Return one page of verification lists for the connected MailerCheck account, with an opaque cursor when another provider-controlled page exists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque cursor returned by a previous call. Pass it unchanged to fetch the next page, or omit it 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 |

### List Verification Results

**Slug:** `MAILERCHECK_LIST_VERIFICATION_RESULTS`

Return one page of email-level results for a verification list, optionally filtered by classification. The success envelope and pagination behavior are based on MailerCheck documentation and were not live-verified because producing results requires a credit-consuming list verification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Requested results per page. MailerCheck documents a default of 100 but does not document a maximum, and live behavior was not verified. |
| `result` | string ("valid" | "catch_all" | "mailbox_full" | "role" | "unknown" | "syntax_error" | "typo" | "mailbox_not_found" | "disposable" | "blocked" | "error") | No | Optional exact verification classification to return. |
| `list_id` | integer | Yes | ID of a list whose verification has been started. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call. Pass it unchanged to fetch the next page; it preserves the list ID, classification filter, and limit. |

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

### Start List Verification

**Slug:** `MAILERCHECK_START_LIST_VERIFICATION`

Irreversibly start verification of every address in a MailerCheck list. A successful call spends one verification credit per address. Before calling, use GET_VERIFICATION_LIST to inspect the list count and GET_CREDIT_BALANCE to confirm the current credit_balance. This endpoint was not live-executed because the authorized verification-credit budget was exhausted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Verification-list ID to start. This irreversible operation spends one MailerCheck verification credit per address in the list. Check the list count and current account credit_balance before calling. |

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

**Slug:** `MAILERCHECK_VERIFY_EMAIL`

Consumes exactly one MailerCheck verification credit on every successful call. Synchronously verify one email address and return its classification; check GET_CREDIT_BALANCE first if cost matters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify. Every successful request spends exactly one MailerCheck verification credit. |

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