Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to ActiveTrail

Scalekit connector
Open markdown

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

Tools
60
What they doRead · write · destructive
38 · 15 · 738 read15 write7 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 ActiveTrail connection

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

    Each user opens the link once and enters their ActiveTrail 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
  • activetrail_account_balance_getGet the email and SMS credit balance of the ActiveTrail account.Read-only

    Get Account Balance

    Get the email and SMS credit balance of the ActiveTrail account. Returns the remaining email and SMS credits. Use this before sending large campaigns.

    Inputs

    This tool takes no inputs.

  • activetrail_automation_activation_getGet whether an ActiveTrail automation is published (active).Read-only

    Get Automation Activation

    Get whether an ActiveTrail automation is published (active). Returns is_published and any scheduled activation time. Use this before activating or pausing it.

    Inputs

    automation_idintegerrequired
    Automation ID, from activetrail_automations_list. Example: 7788.
  • activetrail_automation_getGet the details of an ActiveTrail automation, without its steps.Read-only

    Get Automation

    Get the details of an ActiveTrail automation, without its steps. Returns the automation's name, state, trigger and settings. Use this for an automation's details.

    Inputs

    automation_idintegerrequired
    Automation ID, from activetrail_automations_list. Example: 7788.
  • activetrail_automation_summary_report_getGet the summary report of the email campaigns inside an ActiveTrail automation.Read-only

    Get Automation Summary Report

    Get the summary report of the email campaigns inside an ActiveTrail automation. Returns per-email sent, opens, clicks, bounces and unsubscribes. Use this to measure an automation.

    Inputs

    automation_idintegerrequired
    Automation ID, from activetrail_automations_list. Example: 7788.
    botsboolean
    True includes opens and clicks detected as bots. Example: false.
    from_datestring
    Start date, YYYY-MM-DD. Example: 2026-10-01.
    to_datestring
    End date, YYYY-MM-DD. Example: 2026-10-31.
  • activetrail_automations_listList the automations of the ActiveTrail account, optionally by state.Read-only

    List Automations

    List the automations of the ActiveTrail account, optionally by state. Returns automations with ID, name, state and dates. Use this to find automation IDs.

    Inputs

    limitinteger
    Results per page, 1 to 100 (default 20). Example: 50.
    pageinteger
    Page number, starting at 1. Example: 1.
    state_typeinteger
    State filter: 5 untitled, 10 draft, 15 paused, 20 published, 30 deleted. Example: 20.one of 510152030
  • activetrail_campaign_getGet one ActiveTrail email campaign with its details, design, segment and scheduling.Read-only

    Get Email Campaign

    Get one ActiveTrail email campaign with its details, design, segment and scheduling. Returns the full campaign. Use this to inspect a campaign. Use activetrail_campaign_report_get for its results.

    Inputs

    campaign_idintegerrequired
    Email campaign ID, from activetrail_sent_campaigns_list or activetrail_campaign_reports_list. Example: 987654.
  • activetrail_campaign_report_activity_listList every contact's activity on an ActiveTrail email campaign.Read-only

    List Campaign Email Activity

    List every contact's activity on an ActiveTrail email campaign. Returns per-contact sent, open, click, bounce and unsubscribe flags. Use this for a full per-contact export of one campaign.

    Inputs

    campaign_idintegerrequired
    Email campaign ID, from activetrail_sent_campaigns_list or activetrail_campaign_reports_list. Example: 987654.
    from_datestring
    Start of the last update date range, YYYY-MM-DD. Example: 2026-10-01.
    limitinteger
    Results per page, 1 to 100 (default 20). Example: 50.
    pageinteger
    Page number, starting at 1. Example: 1.
    to_datestring
    End of the last update date range, YYYY-MM-DD. Example: 2026-10-31.
  • activetrail_campaign_report_bounces_listList the bounces of an ActiveTrail email campaign and the bounce count per domain.Read-only

    List Campaign Bounces

    List the bounces of an ActiveTrail email campaign and the bounce count per domain. Returns bounced contacts with bounce type and per-domain totals. Use this to clean bad addresses.

    Inputs

    campaign_idintegerrequired
    Email campaign ID, from activetrail_sent_campaigns_list or activetrail_campaign_reports_list. Example: 987654.
    from_datestring
    Start of the last update date range, YYYY-MM-DD. Example: 2026-10-01.
    limitinteger
    Results per page, 1 to 100 (default 20). Example: 50.
    pageinteger
    Page number, starting at 1. Example: 1.
    to_datestring
    End of the last update date range, YYYY-MM-DD. Example: 2026-10-31.