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

# Bouncify

Bouncify verifies individual email addresses and bulk email lists and reports the account's remaining verification credits.

- **Category:** people & contact data
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `BOUNCIFY`
- **Version:** 20261014_00

## Tools

### Create Bulk List

**Slug:** `BOUNCIFY_CREATE_BULK_LIST`

Submit at least two email records for asynchronous bulk-job preparation without starting verification or consuming credits. Poll Get Bulk Job Status until the job is ready before starting verification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | At least two email records to prepare. One-record jobs are acknowledged but fail asynchronously with no accepted records. Each record requires `email` and may include additional columns that Bouncify retains in downloaded 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 |

### Download Bulk Results

**Slug:** `BOUNCIFY_DOWNLOAD_BULK_RESULTS`

Download selected result classes from a completed bulk-verification job as a CSV file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Completed bulk job ID returned by Create Bulk List. |
| `filter_results` | array | No | Result classes to include in the CSV; defaults to all classes. |

#### 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 Bulk Job Status

**Slug:** `BOUNCIFY_GET_BULK_JOB_STATUS`

Return a bulk job's preparation or verification state, progress, analysis, and result counts. Treat status as authoritative: a failed job can still have success=true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Bulk job ID returned by Create Bulk List. |

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

Return the connected Bouncify account's remaining verification credits without consuming a 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 |

### Request Bulk List Deletion

**Slug:** `BOUNCIFY_REQUEST_BULK_LIST_DELETION`

Permanently request deletion of a bulk list and its results. This operation is irreversible. Bouncify acknowledges an asynchronous or delayed deletion, so success means the request was accepted, not that the job has already disappeared.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Bulk job ID whose list and results should be permanently deleted. Deletion is irreversible and may remain pending after acknowledgment. |

#### 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 Bulk Verification (Irreversible, Consumes Credits)

**Slug:** `BOUNCIFY_START_BULK_VERIFICATION`

Irreversibly start verification for a prepared bulk list. This consumes one verification credit per email and, after a successful start, cannot be paused, stopped, cancelled, or restarted. Check that the job is ready and sufficient credits remain before invoking. The response only acknowledges the start; use Get Bulk Job Status to monitor progress.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Prepared bulk job ID to start. Before calling, confirm the job is ready and the account has enough credits. Starting consumes one credit per email and cannot be paused, stopped, cancelled, or restarted. |

#### 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 (Consumes Credit)

**Slug:** `BOUNCIFY_VERIFY_EMAIL`

Verify one email address in real time. Every successful API call consumes one verification credit, including an address that Bouncify classifies as invalid syntax.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify. Invalid syntax is intentionally accepted because Bouncify returns it as a billable verification result. |
| `timeout_ms` | integer | No | Maximum provider verification time in milliseconds (30,000-180,000). |

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