> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Kickbox

The Kickbox connector lets your AI agent act in each user's Kickbox account. Each user connects their own Kickbox access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 3 tools.

**Authentication:** Bearer Token
**Categories:** Marketing, Developer Tools
**Tools:** 3: 2 read, 1 write, 0 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=KICKBOX)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Kickbox connection

   In **AgentKit > Connections**, create a Kickbox connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'kickbox'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Kickbox:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'kickbox_batch_verify_get',
     toolInput: { job_id: 'YOUR_JOB_ID' },
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "kickbox"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Kickbox:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={"job_id":"YOUR_JOB_ID"},
       tool_name="kickbox_batch_verify_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Kickbox credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'kickbox_batch_verify_get',
  toolInput: {
    job_id: 123,
  },
  connector: 'kickbox',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="kickbox_batch_verify_get",
    tool_input={
        "job_id": 123,
    },
    connection_name="kickbox",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `kickbox_batch_verify_get`

Get Batch Verification · Read-only

Get the status of a Kickbox batch verification job and, once complete, its results link.
Returns id, status (starting, processing, completed or failed), progress counts while processing, and when completed name, stats (deliverable, undeliverable, risky, unknown, sendex, addresses), download_url, created_at, duration and error.
Use kickbox_batch_verify_get to poll a batch job started in the Kickbox app or the Kickbox batch API. Use kickbox_email_verify to verify one address. The download_url is valid for one hour; call again for a fresh one.
Requires the numeric job id that Kickbox returned when the job was started.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`integer`, required): ID of the batch job, as returned by Kickbox when the job was started. Example: 123.

Example input: `{"job_id":123}`

### `kickbox_disposable_check`

Check Disposable Domain · Read-only

Check whether an email address or domain belongs to a known disposable (temporary) email provider. Free; spends no credits.
Returns disposable (true or false).
Use kickbox_disposable_check for a quick, free disposable check. Use kickbox_email_verify for a full deliverability check.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): The email address or bare domain to check. Example: mailinator.com.

Example input: `{"address":"<address>"}`

### `kickbox_email_verify`

Verify Email · Write

Verify one email address in real time and spend one Kickbox verification credit (sandbox keys spend none).
Returns result (deliverable, undeliverable, risky or unknown), reason, role, free, disposable, accept_all, did_you_mean, sendex quality score, email, user and domain, plus threat_score when requested.
Use kickbox_email_verify for one address at a time, such as at sign-up. Use kickbox_disposable_check for a free disposable-domain check only. Keep timeout at 8000 ms or less so the call finishes inside the tool-call time limit.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, required): The email address to verify. Example: bill.lumbergh@gamil.com.
- `include_threat` (`boolean`, optional): Set true to also return a Threat Score (threat_score and threat_level) for the address. Threat Score must be enabled on the Kickbox account; otherwise it is ignored. Costs one extra credit only when a threat signal is found. Do not combine with threat_only. Example: true.
- `threat_only` (`boolean`, optional): Set true to return only the Threat Score, without a standard verification; the usual result fields are then not populated. Threat Score must be enabled on the account. Do not combine with include_threat. Example: true.
- `timeout` (`integer`, optional): Longest time in milliseconds Kickbox may spend on the verification, up to 30000. Kickbox's default is 6000. Use 8000 or less to stay within the tool-call time limit. Example: 6000.

Example input: `{"email":"<email>"}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
