> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# kickbox

> Email Verification

**Server path:** `/kickbox` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                              | Description                           |
| --------------------------------------------------------------------------------- | ------------------------------------- |
| [`kickbox_create_batch_verification`](#kickbox_create_batch_verification)         | Create a batch email verification job |
| [`kickbox_get_account_balance`](#kickbox_get_account_balance)                     | Get account credit balance            |
| [`kickbox_get_batch_verification_status`](#kickbox_get_batch_verification_status) | Get batch verification job status     |
| [`kickbox_verify_single_email`](#kickbox_verify_single_email)                     | Verify a single email address         |

***

## kickbox\_create\_batch\_verification

Create a batch email verification job

**Parameters:**

| Parameter          | Type      | Required | Default | Description                                                        |
| ------------------ | --------- | -------- | ------- | ------------------------------------------------------------------ |
| `callback_headers` | object    | No       | —       | Custom headers to include with the callback webhook                |
| `callback_url`     | string    | No       | —       | URL to receive a webhook notification when the batch job completes |
| `emails`           | string\[] | Yes      | —       | Array of email addresses to verify                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "callback_headers": {
        "type": "object",
        "description": "Custom headers to include with the callback webhook"
      },
      "callback_url": {
        "type": "string",
        "description": "URL to receive a webhook notification when the batch job completes"
      },
      "emails": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of email addresses to verify"
      }
    },
    "required": [
      "PCID",
      "emails"
    ]
  }
  ```
</Expandable>

***

## kickbox\_get\_account\_balance

Get account credit balance

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## kickbox\_get\_batch\_verification\_status

Get batch verification job status

**Parameters:**

| Parameter | Type    | Required | Default | Description                   |
| --------- | ------- | -------- | ------- | ----------------------------- |
| `id`      | integer | Yes      | —       | The batch verification job ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "The batch verification job ID"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## kickbox\_verify\_single\_email

Verify a single email address

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                      |
| --------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------ |
| `email`   | string  | Yes      | —       | The email address to verify (e.g. '[user@example.com](mailto:user@example.com)')                 |
| `timeout` | integer | No       | —       | Maximum time in milliseconds to wait for a response (default 6000). Minimum 6000, maximum 30000. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "email": {
        "type": "string",
        "description": "The email address to verify (e.g. 'user@example.com')"
      },
      "timeout": {
        "type": "integer",
        "description": "Maximum time in milliseconds to wait for a response (default 6000). Minimum 6000, maximum 30000."
      }
    },
    "required": [
      "PCID",
      "email"
    ]
  }
  ```
</Expandable>