Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to UniOne

Scalekit connector
Open markdown

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

Tools
28
What they doRead · write · destructive
12 · 10 · 612 read10 write6 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 UniOne connection

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

    Each user opens the link once and enters their UniOne 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
  • unione_domains_listList the account's or project's sending domains with the status of their last verification and DKIM checks.Read-only

    List Domains

    List the account's or project's sending domains with the status of their last verification and DKIM checks. Returns each domain with verification and DKIM status. Use unione_domains_list to check whether a domain can send.

    Inputs

    domainstring
    Only this domain. Example: yourdomain.com
    limitinteger
    Maximum number of domains to return. Defaults to 50. Example: 50
    offsetinteger
    Index of the first domain to return, starting at 0. Example: 0
  • unione_event_dump_getGet the status of an event dump and, when ready, its file URLs.Read-only

    Get Event Dump

    Get the status of an event dump and, when ready, its file URLs. Returns the dump's status and a list of files to download. Use unione_event_dump_get to poll a dump started with unione_event_dump_create.

    Inputs

    dump_idstringrequired
    Dump ID returned by unione_event_dump_create. Example: fa1f0f13-1d6b-4f8a-8f8b-9f2c5c1d2e3a
  • unione_event_dumps_listList all existing event dumps.Read-only

    List Event Dumps

    List all existing event dumps. Returns each dump's ID, status and files. Use unione_event_dumps_list to see dumps in progress or ready. Use unione_event_dump_get for one.

    Inputs

    This tool takes no inputs.

  • unione_suppression_getGet the suppression records for one email address.Read-only

    Get Suppression

    Get the suppression records for one email address. Returns each record's cause, source, date and whether it can be deleted. Use unione_suppression_get to find out why an address does not receive email. Use unione_suppressions_list to list many.

    Inputs

    emailstringrequired
    Email address to look up. Example: jane@example.com
    all_projectsboolean
    For accounts with projects, true searches every project. Example: false
  • unione_suppressions_listList suppressed addresses since a date, optionally by cause or source, using a cursor for further pages.Read-only

    List Suppressions

    List suppressed addresses since a date, optionally by cause or source, using a cursor for further pages. Returns suppression records and a cursor for the next page. Use unione_suppressions_list to export the suppression list. Use unione_suppression_get for one address.

    Inputs

    causestring
    Only this cause: unsubscribed, temporary_unavailable, permanent_unavailable, complained or blocked. One of: unsubscribed, temporary_unavailable, permanent_unavailable, complained, blocked. Example: complainedone of unsubscribedtemporary_unavailablepermanent_unavailablecomplainedblocked
    cursorstring
    Cursor from the previous response to get the next page; leave empty for the first page. Example: MTI0NTY3
    limitinteger
    Maximum number of records to return. Defaults to 50. Example: 50
    sourcestring
    Only this source: user (added with unione_suppression_set), system or subscriber. One of: user, system, subscriber. Example: systemone of usersystemsubscriber
    start_timestring
    List suppressions from this UTC time (YYYY-MM-DD hh:mm:ss) to now; ignored when cursor is set. Example: 2026-11-01 00:00:00
  • unione_system_infoGet information about the user or project the API key belongs to.Read-only

    Get Account Info

    Get information about the user or project the API key belongs to. Returns the user ID, email, plan, sending limits and, for a project key, the project details. Use unione_system_info to check limits and which account the key belongs to.

    Inputs

    This tool takes no inputs.

  • unione_system_pingCheck that the API key is valid.Read-only

    Ping

    Check that the API key is valid. Returns the user ID the key belongs to. Use unione_system_ping to test the connection. Use unione_system_info for account details.

    Inputs

    This tool takes no inputs.

  • unione_tags_listList the user-defined tags used on emails.Read-only

    List Tags

    List the user-defined tags used on emails. Returns each tag's tag_id and name. Use unione_tags_list to find a tag_id for unione_tag_delete.

    Inputs

    This tool takes no inputs.