# Zerobounce

ZeroBounce is an email validation and deliverability platform that helps businesses improve email marketing performance by identifying and removing invalid or risky email addresses.

- **Category:** email
- **Auth:** API_KEY
- **Tools:** 18
- **Triggers:** 0
- **Slug:** `ZEROBOUNCE`
- **Version:** 20260211_00

## Tools

### Get Activity Data

**Slug:** `ZEROBOUNCE_ACTIVITY_DATA`

Tool to get activity data (opens, clicks, etc.) for a given email. Use after confirming the email address to gauge engagement recency.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address to retrieve activity data for. |

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

### AI Scoring Single Email

**Slug:** `ZEROBOUNCE_AI_SCORING_SINGLE`

Tool to score a single email address using ZeroBounce AI. Use when you need real-time email lead quality feedback before outreach. Example prompt: "Score the email mark@gmail.com."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address to retrieve an AI-generated quality score for. |

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

### Allow or Block List

**Slug:** `ZEROBOUNCE_ALLOW_BLOCK_LIST`

Tool to manage allowlist and blocklist for email validation. Use when you need to programmatically add or modify custom filters before validating emails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rule` | string ("allow" | "block") | Yes | Action for the filter: 'allow' to whitelist, 'block' to blacklist. |
| `value` | string | Yes | The email, domain, MX record, or TLD to filter. |
| `target` | string ("email" | "domain" | "mx" | "tld") | Yes | Level to apply the filter: 'email', 'domain', 'mx', or 'tld'. |

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

### Batch Validate Emails

**Slug:** `ZEROBOUNCE_BATCH_VALIDATE_EMAILS`

Tool to validate a batch of email addresses in real time. Use when you need to validate up to 200 emails at once with optional activity data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_key` | string | No | API key for authentication, automatically added |
| `timeout` | integer | No | Timeout in seconds (10–120). If exceeded, emails marked unknown/greylisted |
| `email_batch` | array | Yes | List of up to 200 email objects to validate |
| `verify_plus` | boolean | No | Use Verify+ validation method (overrides account setting) |
| `activity_data` | boolean | No | Include activity data in the validation results |

#### 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 AI Scoring File

**Slug:** `ZEROBOUNCE_DELETE_AI_SCORING_FILE`

Tool to remove a completed AI scoring file from ZeroBounce servers. Use when the file status is 'Complete' and you need to remove it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | The file ID returned from scoring sendfile API. Files can only be deleted when their status is Complete. |

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

**Slug:** `ZEROBOUNCE_DELETE_FILE`

Tool to delete a file that was submitted for bulk validation. Use when file status is 'Complete'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | The file ID returned when uploading via sendfile API. |

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

### Domain Search File Status

**Slug:** `ZEROBOUNCE_DOMAIN_SEARCH_FILE_STATUS`

Tool to get the processing status of a file submitted for bulk domain search. Use after submitting the file to poll status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | The ID of the domain search job returned by the sendfile API. |

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

### Domain Search Get File

**Slug:** `ZEROBOUNCE_DOMAIN_SEARCH_GET_FILE`

Tool to download the results file for a completed bulk domain search job. Use when you have the file_id and the job is complete.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | The ID of the domain search job returned by the sendfile API. |

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

### Domain Search Send File

**Slug:** `ZEROBOUNCE_DOMAIN_SEARCH_SEND_FILE`

Tool to upload a file for bulk domain search. Use when you have many domains in a CSV/TXT and need to lookup their details in bulk.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | CSV or TXT file to upload for bulk domain search. The file should contain a list of domains to search. |
| `domain_column` | integer | Yes | 1-based index of the column containing domains in the file. |
| `has_header_row` | boolean | No | Whether the first row of the file is a header row. |

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

### Domain Search Single

**Slug:** `ZEROBOUNCE_DOMAIN_SEARCH_SINGLE`

Tool to identify common email address formats for a given domain. Use when you need to guess email patterns for a company based on its domain.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | No | The email domain to search (e.g., 'example.com') |
| `last_name` | string | No | Person's last name for more specific email format matching |
| `first_name` | string | No | Person's first name for more specific email format matching |
| `middle_name` | string | No | Person's middle name for more specific email format matching |
| `company_name` | string | No | The company name to search if domain is not known (e.g., 'Example Inc') |

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

**Slug:** `ZEROBOUNCE_EMAIL_FINDER_DELETE_FILE`

Tool to delete a file that was submitted for bulk email finding. Use when the file processing status is 'Complete' and you need to remove it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | The ID of the file to delete, returned by the email finder sendfile API |

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

### Email Finder File Status

**Slug:** `ZEROBOUNCE_EMAIL_FINDER_FILE_STATUS`

Tool to get the processing status of a file submitted for bulk email finding. Use when you need to poll the progress of a bulk email-finder file upload.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | The file ID returned by the Email Finder send file API |

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

### Email Finder Send File

**Slug:** `ZEROBOUNCE_EMAIL_FINDER_SEND_FILE`

Tool to upload a file for bulk email finding. Use when you have lists of names and domains to find emails in bulk via CSV/TXT upload.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | string | Yes | Raw contents of the CSV or TXT file to upload. |
| `file_name` | string | Yes | Filename including extension (e.g., 'emails.csv'). |
| `domain_column` | integer | Yes | 1-based index of the column containing domains in the file. |
| `has_header_row` | boolean | No | Whether the first row of the file is a header row. |
| `full_name_column` | integer | No | 1-based index of the full name column. Either this or first_name_column is required. |
| `last_name_column` | integer | No | 1-based index of the last name column (optional). |
| `first_name_column` | integer | No | 1-based index of the first name column. Either this or full_name_column is required. |
| `middle_name_column` | integer | No | 1-based index of the middle name column (optional). |

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

**Slug:** `ZEROBOUNCE_GET_API_USAGE`

Tool to retrieve API usage statistics for a given period. Use when you need usage metrics between two dates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | Yes | End date of query in YYYY-MM-DD format. |
| `start_date` | string | Yes | Start date of query in YYYY-MM-DD format. |

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

Tool to retrieve your current ZeroBounce email validation credit balance. Use when you need to monitor remaining credits to avoid service interruptions.

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

**Slug:** `ZEROBOUNCE_GET_EMAIL_FINDER_FILE`

Tool to download the results file for a completed bulk email finder job. Use when you have the file_id and the job is complete.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | The file ID returned when calling email-finder/sendfile |

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

**Slug:** `ZEROBOUNCE_LIST_EVALUATOR`

Tool to evaluate the quality of an email list. Use when you have a list of emails and need a quick health check before full validation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | string | Yes | Raw contents of the CSV or TXT file to upload. |
| `file_name` | string | Yes | Filename including extension (e.g., 'emails.csv'). |
| `email_address_column` | integer | Yes | 1-based index of the column containing 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 |

### List Filters

**Slug:** `ZEROBOUNCE_LIST_FILTERS`

Tool to retrieve all email addresses and domains in your allowlist and blocklist filters. Use when you need to view or audit current filter rules before validation.

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

### Send File

**Slug:** `ZEROBOUNCE_SEND_FILE`

Tool to upload a file for bulk email validation. Use when you need to validate large lists of emails via CSV or TXT file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | string | Yes | Raw contents of the CSV or TXT file to upload. |
| `file_name` | string | Yes | Filename including extension (e.g., 'emails.csv'). |
| `return_url` | string | No | Callback URL to receive notification when file processing is complete (optional). |
| `gender_column` | integer | No | 1-based index of the column containing gender in the file (optional). |
| `has_header_row` | boolean | No | Whether the first row of the file is a header row. |
| `last_name_column` | integer | No | 1-based index of the column containing the last name in the file (optional). |
| `remove_duplicate` | boolean | No | Whether duplicate emails should be removed before processing. |
| `first_name_column` | integer | No | 1-based index of the column containing the first name in the file (optional). |
| `ip_address_column` | integer | No | 1-based index of the column containing IP address in the file (optional). |
| `email_address_column` | integer | Yes | 1-based index of the column containing the email address in the file. |

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

Tool to validate a single email address in real time. Use when you need to confirm deliverability and domain details before sending emails. Each call consumes API credits; set `credits_info: true` to include remaining balance in the response and monitor before credits are exhausted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address to validate. |
| `ip_address` | string | No | Optional client IP to improve geo accuracy. |
| `credits_info` | boolean | No | Include remaining credits info in the response. |

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