Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Callingly

Scalekit connector
Open markdown

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

Tools
40
What they doRead · write · destructive
20 · 16 · 420 read16 write4 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 Callingly connection

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

    Each user opens the link once and enters their Callingly 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
  • callingly_agent_schedule_getGet an agent's weekly availability schedule.Read-only

    Get Agent Schedule

    Get an agent's weekly availability schedule. Returns one entry per weekday with is_available and time ranges. Use callingly_agent_schedule_get before callingly_agent_schedule_update.

    Inputs

    agent_idintegerrequired
    Agent ID, from callingly_agents_list. Example: 123
  • callingly_agents_listList the users (agents) who take calls.Read-only

    List Agents

    List the users (agents) who take calls. Returns each agent's ID, name, phone, do-not-disturb flag, priority, time zone and availability. Use callingly_agents_list to find agent IDs for teams. Use callingly_agent_schedule_get for working hours.

    Inputs

    account_idinteger
    Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1
  • callingly_call_getGet one call by ID.Read-only

    Get Call

    Get one call by ID. Returns the call's direction, status, lead status, duration, recording URL, transcript, agent, lead and team. Use callingly_call_get for a call's details and recording. Use callingly_calls_list to find calls.

    Inputs

    call_idintegerrequired
    Call ID, from callingly_calls_list. Example: 1234
  • callingly_calls_listList calls in a date range, optionally for one team.Read-only

    List Calls

    List calls in a date range, optionally for one team. Returns a page of calls with direction, status, duration, recording URL, lead and agent. Use callingly_calls_list to review call activity. Use callingly_call_get for one call's transcript.

    Inputs

    account_idinteger
    Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1
    endstring
    End date, YYYY-MM-DD. Example: 2026-11-16
    limitinteger
    Results per page, default 10, at most 100. Example: 25
    pageinteger
    Page number, starting at 1. Example: 1
    startstring
    Start date, YYYY-MM-DD. Example: 2026-11-01
    team_idinteger
    Only calls for this team. Example: 123
  • callingly_clients_listList agency client accounts (agency partners only).Read-only

    List Clients

    List agency client accounts (agency partners only). Returns each client's ID, name, email and billed users and numbers. Use callingly_clients_list to get an account_id for acting on a client's account.

    Inputs

    This tool takes no inputs.

  • callingly_conversation_getGet one SMS conversation by ID.Read-only

    Get Conversation

    Get one SMS conversation by ID. Returns the conversation with unread count, last message, lead and number. Use callingly_conversation_get for a thread's summary. Use callingly_conversation_messages_list for its messages.

    Inputs

    conversation_idintegerrequired
    Conversation ID, from callingly_conversations_list. Example: 42
  • callingly_conversation_messages_listList the messages in one SMS conversation, newest first.Read-only

    List Conversation Messages

    List the messages in one SMS conversation, newest first. Returns a page of messages with body, direction and time. Use callingly_conversation_messages_list to read a thread before replying with callingly_sms_create.

    Inputs

    conversation_idintegerrequired
    Conversation ID, from callingly_conversations_list. Example: 42
    limitinteger
    Results per page, default 30, at most 100. Example: 25
    pageinteger
    Page number, starting at 1. Example: 1
  • callingly_conversations_listList SMS conversations (one thread per lead and number), most recently active first.Read-only

    List Conversations

    List SMS conversations (one thread per lead and number), most recently active first. Returns a page of conversations with unread count, last message, lead and number. Use callingly_conversations_list to find threads with unread replies. Use callingly_conversation_messages_list to read one.

    Inputs

    account_idinteger
    Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1
    lead_idinteger
    Only conversations with this lead. Example: 1
    limitinteger
    Results per page, default 10, at most 100. Example: 25
    number_idinteger
    Only conversations on this phone number. Example: 7
    pageinteger
    Page number, starting at 1. Example: 1