Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Twilio

Scalekit connector
Open markdown

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

Tools
61
What they doRead · write · destructive
31 · 22 · 831 read22 write8 destructive
Users sign in with

What you can do

  • Send and manage messages: send SMS and MMS, list and fetch messages and their media, and redact or delete them
  • Make and control calls: place outbound calls, redirect or end live calls, and look up call history
  • Run conferences: dial in, mute, hold, or remove participants and end or update live conferences
  • Verify users: send one-time codes by SMS, call, or email and check the codes users enter
  • Manage phone numbers: search available local, mobile, and toll-free numbers, then buy, configure, or release them
  • Work with conversations: create conversations, add participants, and send, list, or delete messages in them

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 Twilio connection

    In AgentKit > Connections, create a Twilio connection. The name you give it is the connection_name your code passes. See Configure connections.

    Console steps with screenshots

    Connect Twilio to Scalekit using your Account SID and Auth Token. Scalekit stores these credentials securely and injects them into every tool call — your agent code never handles them directly.

    1. Get your Account SID and Auth Token

      • Log in to the Twilio Console.
      • On the Account Dashboard, scroll down to the Account Info section.
      • Copy your Account SID (starts with AC).
      • Click Show next to Auth Token to reveal it, then copy it.

      Twilio Account Dashboard showing Account SID and Auth Token

    2. Create a connection in Scalekit

      • In the Scalekit dashboard, go to AgentKit → Connections → Create Connection.
      • Search for Twilio and click Create.
      • Enter your Account SID in the Account SID field.
      • Enter your Auth Token in the Auth Token field.
      • Click Save and note the Connection name — use this as connection_name in your code.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • twilio_account_getRetrieve details of a Twilio account by its SID.Read-only

    Get Account

    Retrieve details of a Twilio account by its SID.

    Inputs

    This tool takes no inputs.

  • twilio_accounts_listList accounts and subaccounts belonging to the current Twilio account, optionally filtered by friendly name or status.Read-only

    List Accounts

    List accounts and subaccounts belonging to the current Twilio account, optionally filtered by friendly name or status.

    Inputs

    friendly_namestring
    Only return accounts matching this exact friendly name.
    page_sizeinteger
    The number of accounts to return per page.
    statusstring
    Only return accounts with this status.one of activesuspendedclosed
  • twilio_applications_listList TwiML Applications on the account, optionally filtered by friendly name.Read-only

    List Applications

    List TwiML Applications on the account, optionally filtered by friendly name.

    Inputs

    friendly_namestring
    Only return applications matching this exact friendly name.
    page_sizeinteger
    The number of applications to return per page.
  • twilio_available_numbers_localSearch for available local phone numbers that can be purchased in a given country.Read-only

    Search Available Local Numbers

    Search for available local phone numbers that can be purchased in a given country.

    Inputs

    country_codestringrequired
    The ISO 3166-1 alpha-2 country code to search for numbers in.
    area_codestring
    Filter by area code.
    containsstring
    A pattern to match phone numbers against. Use * for wildcards.
    sms_enabledstring
    Filter for numbers that are SMS-capable.
    voice_enabledstring
    Filter for numbers that are voice-capable.
  • twilio_available_numbers_mobileSearch for available mobile phone numbers that can be purchased in a given country.Read-only

    Search Available Mobile Numbers

    Search for available mobile phone numbers that can be purchased in a given country.

    Inputs

    country_codestringrequired
    Two-letter country code (e.g., GB, DE).
    area_codestring
    Filter by area code.
    containsstring
    A pattern to match phone numbers against. Use * for wildcards.
    sms_enabledstring
    Only return SMS-capable numbers.
    voice_enabledstring
    Only return voice-capable numbers.
  • twilio_available_numbers_toll_freeSearch for available toll-free phone numbers that can be purchased in a given country.Read-only

    Search Available Toll-Free Numbers

    Search for available toll-free phone numbers that can be purchased in a given country.

    Inputs

    country_codestringrequired
    The ISO 3166-1 alpha-2 country code to search for numbers in.
    area_codestring
    Filter by area code.
    containsstring
    A pattern to match phone numbers against. Use * for wildcards.
  • twilio_balance_getGet the current account's balance and currency.Read-only

    Get Account Balance

    Get the current account's balance and currency.

    Inputs

    This tool takes no inputs.

  • twilio_call_getRetrieve details of a specific phone call by its SID, including status, duration, and pricing information.Read-only

    Get Call

    Retrieve details of a specific phone call by its SID, including status, duration, and pricing information.

    Inputs

    call_sidstringrequired
    The unique identifier of the Call resource to retrieve.