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

# SMTPing

Verify email addresses, check threat lists, and inspect SMTPing account credits and usage.

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

## Tools

### Check Email

**Slug:** `SMTPING_CHECK_EMAIL`

Check one email address against one selected SMTPing threat list and report whether it matched. Consumes one credit; SMTPing limits synchronous calls to 10 per minute.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to check against the selected threat list. |
| `check_type` | string ("spamtrap" | "disposable" | "spambot" | "complainer") | Yes | Threat list to check: spamtrap, disposable, spambot, or complainer. |

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

### Check Email Batch

**Slug:** `SMTPING_CHECK_EMAIL_BATCH`

Synchronously check 1 to 1,000 email addresses against one selected SMTPing threat list and return all results. Consumes one credit per unique address; SMTPing limits synchronous calls to 10 per minute.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | Email addresses to check synchronously against the selected threat list (1-1,000 addresses). |
| `check_type` | string ("spamtrap" | "disposable" | "spambot" | "complainer") | Yes | Threat list to check: spamtrap, disposable, spambot, or complainer. |

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

### Check Email Flags

**Slug:** `SMTPING_CHECK_EMAIL_FLAGS`

Return all six SMTPing risk and domain flags for one email address in one request. Consumes one credit; SMTPing limits synchronous calls to 10 per minute.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address for which to retrieve all risk and domain flags. |

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

### Create Bulk Check Job

**Slug:** `SMTPING_CREATE_BULK_CHECK_JOB`

Start an asynchronous SMTPing threat-list check for 1 to 100,000 email addresses. Returns a job ID for status polling and consumes one credit per unique address. SMTPing limits job submissions to two per hour.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | Email addresses to check asynchronously against the selected threat list (1-100,000 addresses). |
| `check_type` | string ("spamtrap" | "disposable" | "spambot" | "complainer") | Yes | Threat list to check: spamtrap, disposable, spambot, or complainer. |

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

### Create Bulk Verification Job

**Slug:** `SMTPING_CREATE_BULK_VERIFICATION_JOB`

Start asynchronous verification for 1 to 100,000 email addresses and return the job ID to use for status polling and result retrieval. Consumes one credit per unique address as work completes; duplicates and unknown results are free. SMTPing limits job submissions to two per hour.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | Email addresses to verify asynchronously (1-100,000 addresses). Duplicate addresses are removed case-insensitively and billed once. |

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

### Export Usage

**Slug:** `SMTPING_EXPORT_USAGE`

Download SMTPing usage history as a CSV file for the provider's default date range. No date filters are exposed because none are documented.

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

**Slug:** `SMTPING_GET_BULK_CHECK_JOB`

Get progress and match counts for an asynchronous threat-list check job. Poll every 20 to 30 seconds until status is Succeeded or Completed before fetching results; polling is free.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Bulk check job ID returned by CREATE_BULK_CHECK_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 |

### Get Bulk Check Results

**Slug:** `SMTPING_GET_BULK_CHECK_RESULTS`

Return all address-level matches for a bulk threat-list check job after its status is Succeeded or Completed. Returns 409 while incomplete; fetching results is free.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Completed bulk check job ID returned by CREATE_BULK_CHECK_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 |

### Get Bulk Verification Job

**Slug:** `SMTPING_GET_BULK_VERIFICATION_JOB`

Get progress and summary counts for an asynchronous bulk verification job. Poll every 20 to 30 seconds until status is Succeeded before fetching results; polling is free.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Bulk verification job ID returned by CREATE_BULK_VERIFICATION_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 |

### Get Bulk Verification Results

**Slug:** `SMTPING_GET_BULK_VERIFICATION_RESULTS`

Return all address-level results for a bulk verification job after its status is Succeeded. Returns 409 while the job is incomplete; fetching results is free.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Completed bulk verification job ID returned by CREATE_BULK_VERIFICATION_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 |

### Get Credits

**Slug:** `SMTPING_GET_CREDITS`

Return the connected account's current credit balance, plan, and daily remaining credits. This free read is the balance source of truth.

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

**Slug:** `SMTPING_GET_USAGE`

Return aggregate request, email, credit, status, endpoint, and error usage for SMTPing's current default date range. No date filters are exposed because none are documented or verified. This account read is free.

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

**Slug:** `SMTPING_LIST_USAGE_REQUESTS`

Return the newest available page of individual SMTPing API request history, up to the provider default of 50 rows, with page metadata. No continuation input is exposed because request-side pagination parameters are undocumented and unverified.

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

Verify one email address and return its deliverability status and domain flags. SMTPing charges one credit unless the result is unknown and limits synchronous calls to 10 per minute. Source: https://smtping.com/openapi.json#/paths/~1verify~1single/post

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | 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 |