# Emailable

Emailable provides an email verification API that allows developers to integrate real-time email validation into their applications, ensuring the accuracy and deliverability of email addresses.

- **Category:** email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `EMAILABLE`
- **Version:** 20260309_00

## Tools

### Get Account Info

**Slug:** `EMAILABLE_GET_ACCOUNT_INFO`

Tool to retrieve account information including owner email and available credits. Use when you need to confirm account status before sending 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 |

### Get Batch Status

**Slug:** `EMAILABLE_GET_BATCH_STATUS`

Tool to get the status and results of a batch verification job. Use after submitting a batch to check its progress.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_id` | string | Yes | The unique identifier for the batch verification job returned when creating a batch. |

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

### Build OAuth Authorization URL

**Slug:** `EMAILABLE_O_AUTH_AUTHORIZE`

Build an OAuth 2.0 authorization URL for the Emailable authorization code flow. Returns a URL to redirect users to for authorization. Upon successful authorization, users are redirected to your redirect_uri with an authorization code (valid for 10 minutes) that can be exchanged for access tokens.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `state` | string | No | An arbitrary string to maintain state between the request and callback. The server returns it unchanged. Used to prevent CSRF attacks. |
| `client_id` | string | Yes | Your OAuth App's client ID from the Emailable developer dashboard |
| `redirect_uri` | string | Yes | The registered redirect URI of your OAuth App where the authorization code will be sent |
| `response_type` | string | No | Must be 'code' for authorization code flow. This is the only supported value. |

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

**Slug:** `EMAILABLE_VERIFY_BATCH_EMAILS`

Submit a batch of email addresses for asynchronous verification. Returns a batch ID immediately. Use this for bulk email validation (2 to 50,000 emails). For single emails, use EMAILABLE_VERIFY_EMAIL instead. The batch is processed asynchronously - use EMAILABLE_GET_BATCH_STATUS with the returned batch ID to check progress and retrieve verification results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | List of email addresses to verify. Must contain at least 2 emails (use EMAILABLE_VERIFY_EMAIL for single emails). Maximum 50,000 emails per batch. |

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

Tool to verify a single email address and return detailed results. Use when you need to check email deliverability and risk.

#### Input Parameters

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

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