> **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 Bouncer

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

**Authentication:** API Key
**Categories:** Marketing, Automation
**Tools:** 13: 5 read, 6 write, 2 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=BOUNCER)

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

   In **AgentKit > Connections**, create a Bouncer 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 = 'bouncer'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Bouncer:', 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: 'bouncer_credits_get',
     toolInput: {},
   })
   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 = "bouncer"
   identifier = "user_123"

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

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

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Bouncer 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: 'bouncer_batch_results_get',
  toolInput: {
    batch_id: '<batch_id>',
  },
  connector: 'bouncer',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="bouncer_batch_results_get",
    tool_input={
        "batch_id": "<batch_id>",
    },
    connection_name="bouncer",
    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.

### `bouncer_batch_results_get`

Get Batch Results · Read-only

Download the results of a completed verification batch, optionally only one result status.
Returns a list of email records, each with status, reason, domain and account flags, score and toxicity.
Use this once bouncer_batch_status_get reports completed.

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

Inputs:

- `batch_id` (`string`, required): Batch ID returned by bouncer_batch_create. Example: 61f1e8d1c3a2b4001234abcd.
- `download` (`string`, optional): Which results to download: all, deliverable, risky, undeliverable or unknown. Defaults to all. Example: deliverable. One of: `all`, `deliverable`, `risky`, `undeliverable`, `unknown`.

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

### `bouncer_batch_status_get`

Get Batch Status · Read-only

Get the status of a verification batch.
Returns status (queued, processing or completed), counts and, with with_stats, result statistics.
Use this to poll a batch from bouncer_batch_create. Use bouncer_batch_results_get when it is completed.

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

Inputs:

- `batch_id` (`string`, required): Batch ID returned by bouncer_batch_create. Example: 61f1e8d1c3a2b4001234abcd.
- `with_stats` (`boolean`, optional): Include processing statistics (counts per result status). Defaults to false. Example: true.

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

### `bouncer_credits_get`

Get Credits · Read-only

Get the Bouncer account's available verification credits.
Returns the credits balance.
Use this before large batches, or to confirm the connection works.

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

Inputs: none.

Example input: `{}`

### `bouncer_toxicity_list_results_get`

Get Toxicity Check Results · Read-only

Download the results of a completed toxicity check.
Returns each email with its toxicity score from 0 (safe) to 5 (very toxic).
Use this once bouncer_toxicity_list_status_get reports completed.

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

Inputs:

- `id` (`string`, required): Toxicity list job ID returned by bouncer_toxicity_list_create. Example: 61f1e8d1c3a2b4001234abce.

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

### `bouncer_toxicity_list_status_get`

Get Toxicity Check Status · Read-only

Get the status of a toxicity check job.
Returns the job id and status.
Use bouncer_toxicity_list_results_get when it is completed.

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

Inputs:

- `id` (`string`, required): Toxicity list job ID returned by bouncer_toxicity_list_create. Example: 61f1e8d1c3a2b4001234abce.

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

### `bouncer_batch_create`

Create Batch · Write

Submit a list of email addresses (up to 100,000; 1,000 to 10,000 recommended) for asynchronous verification. Uses one credit per address.
Returns the batchId, its status and the number of emails queued.
Use this for lists. Poll bouncer_batch_status_get until completed, then read bouncer_batch_results_get.

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

Inputs:

- `emails` (`array`, required): Email addresses to verify. Example: ["jane@example.com", "john@example.com"]
- `callback` (`string`, optional): URL Bouncer calls when the batch is finished. Example: https://example.com/hooks/bouncer.

Example input: `{"emails":["jane@example.com","john@example.com"]}`

### `bouncer_batch_finish`

Finish Batch · Write

Stop a running batch early: emails not yet verified are skipped and their credits returned.
Returns a confirmation.
Download what was verified with bouncer_batch_results_get once bouncer_batch_status_get reports completed.

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

Inputs:

- `batch_id` (`string`, required): Batch ID returned by bouncer_batch_create. Example: 61f1e8d1c3a2b4001234abcd.

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

### `bouncer_batch_sync_verify`

Verify Emails (Batch Sync) · Write

Verify up to 10,000 email addresses through the batch queue and wait for the results in the same call. Uses one credit per address (results are reused for 24 hours).
Returns a list of email records with status, reason, domain and account flags, score and toxicity.
Use this for small lists when you want results in one call; it can take a long time. Use bouncer_batch_create for large lists.

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

Inputs:

- `emails` (`array`, required): Email addresses to verify, at most 10,000. Example: ["jane@example.com", "john@example.com"]

Example input: `{"emails":["jane@example.com","john@example.com"]}`

### `bouncer_domain_verify`

Verify Domain · Write

Check a domain's email setup.
Returns whether it has valid MX records, accepts all addresses (catch-all), is disposable or free, and its provider.
Use this to judge a whole domain. Use bouncer_email_verify for one address.

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

Inputs:

- `domain` (`string`, required): Domain to check, without @ or protocol. Example: example.com.

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

### `bouncer_email_verify`

Verify Email · Write

Verify one email address in real time, checking syntax, domain and the mail server. Uses one credit.
Returns status (deliverable, risky, undeliverable or unknown), reason, domain and account flags, DNS, provider, score and toxicity.
Use this for a single address. Use bouncer_batch_create for many addresses, which gives fewer unknown results.

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

Inputs:

- `email` (`string`, required): Email address to verify. Example: jane@example.com.
- `timeout` (`integer`, optional): Seconds to wait for a result, up to 30; slow servers return unknown when it runs out. Defaults to 10. Example: 10.

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

### `bouncer_toxicity_list_create`

Create Toxicity Check · Write

Start a toxicity check for a list of email addresses, scoring how risky each one is to mail (spam traps, complainers, breached addresses).
Returns the job id and status.
Poll bouncer_toxicity_list_status_get, then read bouncer_toxicity_list_results_get.

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

Inputs:

- `emails` (`array`, required): Email addresses to check. Example: ["jane@example.com", "john@example.com"]

Example input: `{"emails":["jane@example.com","john@example.com"]}`

### `bouncer_batch_delete`

Delete Batch · Destructive

Delete a verification batch and the emails in it. Its results are lost.
Returns a confirmation.
This cannot be undone.

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

Inputs:

- `batch_id` (`string`, required): Batch ID returned by bouncer_batch_create. Example: 61f1e8d1c3a2b4001234abcd.

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

### `bouncer_toxicity_list_delete`

Delete Toxicity Check · Destructive

Delete a toxicity check job and its results.
Returns a confirmation.
This cannot be undone.

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

Inputs:

- `id` (`string`, required): Toxicity list job ID returned by bouncer_toxicity_list_create. Example: 61f1e8d1c3a2b4001234abce.

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

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