Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Enginemailer

Scalekit connector
Open markdown

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

Tools
26
What they doRead · write · destructive
9 · 14 · 39 read14 write3 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 Enginemailer connection

    In AgentKit > Connections, create an Enginemailer 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 = 'enginemailer'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Enginemailer:', 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: 'enginemailer_campaign_categories_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Enginemailer 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
  • enginemailer_campaign_categories_listList the subscriber categories available for campaign targeting.Read-only

    List Campaign Categories

    List the subscriber categories available for campaign targeting. Returns categories with ID and name. Use List Campaign Subcategories for a category's subcategories.

    Inputs

    This tool takes no inputs.

  • enginemailer_campaign_delivery_status_getGet delivery and engagement stats for a delivered campaign.Read-only

    Get Campaign Delivery Status

    Get delivery and engagement stats for a delivered campaign. Returns emails sent, delivered, bounces, opens, unique opens, clicks, unique clicks, unsubscribes and spam complaints. Only campaigns with status Delivered are eligible.

    Inputs

    campaign_idintegerrequired
    Enginemailer campaign ID, from List Campaigns or Create Campaign. Example: 1234.
  • enginemailer_campaign_subcategories_listList the subcategories in one category, for campaign targeting.Read-only

    List Campaign Subcategories

    List the subcategories in one category, for campaign targeting. Returns subcategories with ID and name. Use the IDs in Assign Recipient List.

    Inputs

    category_idintegerrequired
    Category ID, from List Campaign Categories. Example: 1.
  • enginemailer_campaigns_listList the account's undelivered campaigns.Read-only

    List Campaigns

    List the account's undelivered campaigns. Returns the undelivered campaigns with their IDs and details. Use Get Campaign Delivery Status for delivered campaigns' stats.

    Inputs

    This tool takes no inputs.

  • enginemailer_custom_fields_listList the subscriber custom fields defined in the account.Read-only

    List Custom Fields

    List the subscriber custom fields defined in the account. Returns each field with its key and type. Use the field keys in Insert Subscriber or Update Subscriber.

    Inputs

    This tool takes no inputs.

  • enginemailer_subcategories_getList the subscriber categories and their subcategories (lists).Read-only

    Get Subcategories

    List the subscriber categories and their subcategories (lists). Returns the categories with their subcategory IDs and names. Use the subcategory IDs in Insert Subscriber or Update Subscriber.

    Inputs

    include_active_subscriber_countboolean
    Include each subcategory's active subscriber count (whitelisted accounts only). Example: true.
  • enginemailer_subscriber_getGet one subscriber by email address.Read-only

    Get Subscriber

    Get one subscriber by email address. Returns the subscriber ID, status and custom field values. Use Insert Subscriber to add a new one.

    Inputs

    emailstringrequired
    The subscriber's email address. Example: jane@example.com.
  • enginemailer_subscribers_batch_update_statusGet the status of a Batch Update Subscribers job.Read-only

    Get Batch Update Status

    Get the status of a Batch Update Subscribers job. Returns the job's status. Use Batch Update Subscribers to start a job.

    Inputs

    import_idintegerrequired
    ImportID returned by Batch Update Subscribers. Example: 1234.