Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Mailboxlayer

Scalekit connector
Open markdown

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

Tools
2
What they doRead · write · destructive
2 · 0 · 02 read0 write0 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Mailboxlayer connection

    In AgentKit > Connections, create a Mailboxlayer connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    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 = 'mailboxlayer'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Mailboxlayer:', 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: 'mailboxlayer_email_bulk_check',
    toolInput: { email: 'support@apilayer.com,sales@apilayer.com' },
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Mailboxlayer credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • mailboxlayer_email_bulk_checkVerify several email addresses in one call, with the same checks as Verify Email Address.Read-only

    Verify Email Addresses in Bulk

    Verify several email addresses in one call, with the same checks as Verify Email Address. Needs a Mailboxlayer plan that includes bulk checks. Returns an array with one result per address. Use this for lists. Use Verify Email Address for one.

    Inputs

    emailstringrequired
    Email addresses to verify, comma-separated. Example: support@apilayer.com,sales@apilayer.com.
    smtpinteger
    1 (default) to run the SMTP mailbox check, 0 to skip it for a faster answer. Example: 0.one of 01
  • mailboxlayer_email_checkVerify one email address: syntax, typos, MX records, SMTP mailbox check, and whether it is catch-all, role-based, disposable or a free provider.Read-only

    Verify Email Address

    Verify one email address: syntax, typos, MX records, SMTP mailbox check, and whether it is catch-all, role-based, disposable or a free provider. Returns email, did_you_mean, user, domain, format_valid, mx_found, smtp_check, catch_all, role, disposable, free and score (0 to 1). Use this for one address. Use Verify Email Addresses in Bulk for many.

    Inputs

    emailstringrequired
    Email address to verify. Example: support@apilayer.com.
    smtpinteger
    1 (default) to run the SMTP mailbox check, 0 to skip it for a faster answer. Example: 0.one of 01