Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Kadoa

Scalekit connector
Open markdown

The Kadoa connector lets your AI agent act in each user's Kadoa account. Each user connects their own Kadoa 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
26 · 27 · 726 read27 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 Kadoa connection

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

    Each user opens the link once and enters their Kadoa 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
  • kadoa_change_getGet one data change with its records, optionally only added, removed or changed ones, sorted and paged.Read-only

    Get Data Change

    Get one data change with its records, optionally only added, removed or changed ones, sorted and paged. Returns the change and its differing records. Use this to inspect a change from kadoa_changes_list.

    Inputs

    change_idstringrequired
    ID of the data change. Example: 6a1f2c3d4e5f6a7b8c9d0e99.
    excludestring
    Comma-separated fields to leave out of each change, e.g. data or differences. Example: data.
    limitinteger
    Maximum number of differences to return (maximum 100; larger values return 400). Without it, all differences are returned. Use differencesCounts for the totals. Example: 25.
    orderstring
    Sort order: asc or desc. One of: asc, desc. Example: desc.one of ascdesc
    skipinteger
    Number of items to skip, for paging. Example: 0.
    sort_bystring
    Field key to sort differences by; without it, differences are grouped by type. Example: createdAt.
    typestring
    Return only differences of this type. One of: added, removed, changed. Example: added.one of addedremovedchanged
  • kadoa_changes_listList the data changes Kadoa detected between runs of monitored workflows, optionally for some workflows and a date range.Read-only

    List Data Changes

    List the data changes Kadoa detected between runs of monitored workflows, optionally for some workflows and a date range. Returns per change its ID, workflow, date, and added, removed and changed records. Use this to track what changed on monitored sites. Use kadoa_change_get for one change.

    Inputs

    end_datestring
    Only changes on or before this ISO 8601 date-time. Example: 2026-06-30T23:59:59Z.
    excludestring
    Comma-separated fields to leave out of each change, e.g. data or differences. Example: data.
    limitinteger
    Number of records to return (maximum 100; larger values return 400). Defaults to 25. Example: 25.
    skipinteger
    Number of items to skip, for paging. Example: 0.
    start_datestring
    Only changes on or after this ISO 8601 date-time. Example: 2026-01-01T00:00:00Z.
    workflow_idsstring
    Comma-separated workflow IDs to filter by. Example: 6a1f2c3d4e5f6a7b8c9d0e1f.
  • kadoa_notification_channel_getGet one notification channel.Read-only

    Get Notification Channel

    Get one notification channel. Returns its name, type and config. Use this when you know the channel ID.

    Inputs

    channel_idstringrequired
    ID of the notification channel. Example: 6a1f2c3d4e5f6a7b8c9d0e66.
    include_configurationsboolean
    Set to true to include the channel's settings. Defaults to true. Example: true.
  • kadoa_notification_channels_listList notification channels (email, Slack, webhook, websocket), optionally those used by one workflow.Read-only

    List Notification Channels

    List notification channels (email, Slack, webhook, websocket), optionally those used by one workflow. Returns per channel its ID, name, type and config. Use this to find channel IDs for notification settings.

    Inputs

    include_configurationsboolean
    Set to true to include each channel's settings. Defaults to true. Example: true.
    workflow_idstring
    Only channels used by this workflow. Example: 6a1f2c3d4e5f6a7b8c9d0e1f.
  • kadoa_notification_event_types_listList the event types you can be notified about, such as workflow_finished, workflow_failed and workflow_data_change.Read-only

    List Notification Event Types

    List the event types you can be notified about, such as workflow_finished, workflow_failed and workflow_data_change. Returns each type with its description. Use this to choose an event for a notification setting.

    Inputs

    This tool takes no inputs.

  • kadoa_notification_setting_getGet one notification setting.Read-only

    Get Notification Setting

    Get one notification setting. Returns its workflow, event type, enabled flag and channels. Use this when you know the setting ID.

    Inputs

    settings_idstringrequired
    ID of the notification setting. Example: 6a1f2c3d4e5f6a7b8c9d0e88.
  • kadoa_notification_settings_listList notification settings, optionally for one workflow or event type.Read-only

    List Notification Settings

    List notification settings, optionally for one workflow or event type. Returns per setting its ID, workflow, event type, enabled flag and channels. Use this to see who gets notified of what.

    Inputs

    event_typestring
    Only settings for this event type. One of: workflow_started, workflow_finished, workflow_failed, workflow_sample_finished, workflow_data_change, system_maintenance, service_degradation, credits_low, free_trial_ending. Example: workflow_finished.one of workflow_startedworkflow_finishedworkflow_failedworkflow_sample_finishedworkflow_data_changesystem_maintenanceservice_degradationcredits_lowfree_trial_ending
    workflow_idstring
    Only settings of this workflow. Example: 6a1f2c3d4e5f6a7b8c9d0e1f.
  • kadoa_schema_getGet one extraction schema.Read-only

    Get Schema

    Get one extraction schema. Returns its name, entity and fields. Use this when you know the schema ID.

    Inputs

    schema_idstringrequired
    ID of the schema. Find it with kadoa_schemas_list. Example: 6a1f2c3d4e5f6a7b8c9d0e33.