Twilio connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

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. Set up the connector

   Register your Twilio credentials with Scalekit so it can authenticate requests on your behalf. You do this once per environment.

   Dashboard setup steps

   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.

      

   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.

What you can do

Connect this agent connector to let your agent:

• List verify services, usage records, recordings — List all Twilio Verify services on the account
• Get verify service, verification, recording — Retrieve details of a specific Twilio Verify service by its SID
• Delete verify service, recording, message — Delete a Twilio Verify service by its SID
• Create verify service — Create a new Twilio Verify service for sending verification codes via SMS, call, email, or WhatsApp
• Today usage records — Retrieve today’s usage records for a Twilio account, optionally filtered by category
• Free available numbers toll — Search for available toll-free phone numbers that can be purchased in a given country

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

twilio_account_get # Retrieve details of a Twilio account by its SID. 0 params ▾

Retrieve details of a Twilio account by its SID.

twilio_available_numbers_local # Search for available local phone numbers that can be purchased in a given country. 5 params ▾

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

Name Type Required Description

country_code string required The ISO 3166-1 alpha-2 country code to search for numbers in.

area_code string optional Filter by area code.

contains string optional A pattern to match phone numbers against. Use * for wildcards.

sms_enabled string optional Filter for numbers that are SMS-capable.

voice_enabled string optional Filter for numbers that are voice-capable.

twilio_available_numbers_toll_free # Search for available toll-free phone numbers that can be purchased in a given country. 3 params ▾

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

Name Type Required Description

country_code string required The ISO 3166-1 alpha-2 country code to search for numbers in.

area_code string optional Filter by area code.

contains string optional A pattern to match phone numbers against. Use * for wildcards.

twilio_call_delete # Delete a call record from the account. This permanently removes the call log entry. 1 param ▾

Delete a call record from the account. This permanently removes the call log entry.

Name Type Required Description

call_sid string required The unique identifier of the Call resource to delete.

twilio_call_get # Retrieve details of a specific phone call by its SID, including status, duration, and pricing information. 1 param ▾

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

Name Type Required Description

call_sid string required The unique identifier of the Call resource to retrieve.

twilio_calls_list # Retrieve a list of phone calls made to and from the account, with optional filtering by number, status, and date. 6 params ▾

Retrieve a list of phone calls made to and from the account, with optional filtering by number, status, and date.

Name Type Required Description

end_time string optional Filter by calls started on or before this date (YYYY-MM-DD format).

from_number string optional Filter by the phone number that initiated the call.

page_size integer optional The number of results to return per page. Maximum is 1000.

start_time string optional Filter by calls started on or after this date (YYYY-MM-DD format).

status string optional Filter by call status. Values: queued, ringing, in-progress, completed, busy, failed, no-answer, canceled.

to string optional Filter by the phone number that received the call.

twilio_conference_get # Retrieve details of a specific conference by its SID, including status, friendly name, and region. 1 param ▾

Retrieve details of a specific conference by its SID, including status, friendly name, and region.

Name Type Required Description

conference_sid string required The unique identifier of the Conference resource to retrieve.

twilio_conferences_list # Retrieve a list of conferences for the account, with optional filtering by name, status, date, and pagination. 4 params ▾

Retrieve a list of conferences for the account, with optional filtering by name, status, date, and pagination.

Name Type Required Description

date_created string optional Filter conferences created on this date (YYYY-MM-DD format).

friendly_name string optional Filter conferences by their friendly name.

page_size integer optional The number of results to return per page. Maximum is 1000.

status string optional Filter by conference status. Values: init, in-progress, completed.

twilio_conversation_delete # Delete a Twilio Conversation by its SID. This permanently removes the conversation and all associated data. 1 param ▾

Delete a Twilio Conversation by its SID. This permanently removes the conversation and all associated data.

Name Type Required Description

conversation_sid string required The unique SID of the conversation to delete.

twilio_conversation_get # Retrieve the details of a specific Twilio Conversation by its SID. 1 param ▾

Retrieve the details of a specific Twilio Conversation by its SID.

Name Type Required Description

conversation_sid string required The unique SID of the conversation to retrieve.

twilio_conversation_message_delete # Delete a specific message from a Twilio Conversation by its SID. 2 params ▾

Delete a specific message from a Twilio Conversation by its SID.

Name Type Required Description

conversation_sid string required The unique SID of the conversation containing the message.

message_sid string required The unique SID of the message to delete.

twilio_conversation_messages_list # List all messages in a Twilio Conversation. Optionally control the sort order and page size. 3 params ▾

List all messages in a Twilio Conversation. Optionally control the sort order and page size.

Name Type Required Description

conversation_sid string required The unique SID of the conversation to list messages for.

order string optional The sort order of messages. One of: asc, desc.

page_size integer optional The number of messages to return per page.

twilio_conversation_participants_list # List all participants in a Twilio Conversation. 2 params ▾

List all participants in a Twilio Conversation.

Name Type Required Description

conversation_sid string required The unique SID of the conversation to list participants for.

page_size integer optional The number of participants to return per page.

twilio_conversations_list # List all Twilio Conversations. Optionally filter by state and control page size. 2 params ▾

List all Twilio Conversations. Optionally filter by state and control page size.

Name Type Required Description

page_size integer optional The number of conversations to return per page.

state string optional Filter conversations by state. One of: active, inactive, closed.

twilio_message_delete # Permanently delete a message resource from your Twilio account. This action cannot be undone. 1 param ▾

Permanently delete a message resource from your Twilio account. This action cannot be undone.

Name Type Required Description

message_sid string required The unique identifier of the message to delete

twilio_message_get # Retrieve the details of a specific message by its SID. 1 param ▾

Retrieve the details of a specific message by its SID.

Name Type Required Description

message_sid string required The unique identifier of the message to retrieve

twilio_message_media_list # Retrieve a list of media resources associated with a specific message. 2 params ▾

Retrieve a list of media resources associated with a specific message.

Name Type Required Description

message_sid string required The SID of the message to list media for

page_size integer optional Number of media resources to return per page (1-1000, default 50)

twilio_messages_list # Retrieve a list of messages associated with your Twilio account, with optional filtering by recipient, sender, or date sent. 4 params ▾

Retrieve a list of messages associated with your Twilio account, with optional filtering by recipient, sender, or date sent.

Name Type Required Description

date_sent string optional Filter by date sent (YYYY-MM-DD format)

from_number string optional Filter by messages sent from this phone number in E.164 format

page_size integer optional Number of messages to return per page (1-1000, default 50)

to string optional Filter by messages sent to this phone number in E.164 format

twilio_messaging_services_list # Retrieve a list of all Messaging Services associated with your Twilio account. 1 param ▾

Retrieve a list of all Messaging Services associated with your Twilio account.

Name Type Required Description

page_size integer optional Number of Messaging Services to return per page (1-1000, default 50)

twilio_phone_number_get # Retrieve details of a specific incoming phone number by its SID. 1 param ▾

Retrieve details of a specific incoming phone number by its SID.

Name Type Required Description

phone_number_sid string required The SID of the incoming phone number to retrieve.

twilio_phone_numbers_list # List all incoming phone numbers on the Twilio account. 3 params ▾

List all incoming phone numbers on the Twilio account.

Name Type Required Description

friendly_name string optional Filter by friendly name of the phone number.

page_size integer optional Number of results to return per page.

phone_number string optional Filter by phone number in E.164 format.

twilio_recording_delete # Permanently delete a call recording from the account. This action cannot be undone. 1 param ▾

Permanently delete a call recording from the account. This action cannot be undone.

Name Type Required Description

recording_sid string required The unique identifier of the Recording resource to delete.

twilio_recording_get # Retrieve details of a specific call recording by its SID, including duration, status, and source. 1 param ▾

Retrieve details of a specific call recording by its SID, including duration, status, and source.

Name Type Required Description

recording_sid string required The unique identifier of the Recording resource to retrieve.

twilio_recordings_list # Retrieve a list of call recordings for the account, with optional filtering by call SID, date, and pagination. 3 params ▾

Retrieve a list of call recordings for the account, with optional filtering by call SID, date, and pagination.

Name Type Required Description

call_sid string optional Filter recordings by the Call SID they are associated with.

date_created string optional Filter recordings created on this date (YYYY-MM-DD format).

page_size integer optional The number of results to return per page. Maximum is 1000.

twilio_usage_records_list # Retrieve usage records for a Twilio account, optionally filtered by category and date range. 4 params ▾

Retrieve usage records for a Twilio account, optionally filtered by category and date range.

Name Type Required Description

category string optional The usage category to filter by (e.g., sms, calls, phonenumbers).

end_date string optional The end date for the usage records in YYYY-MM-DD format.

page_size integer optional Number of results to return per page.

start_date string optional The start date for the usage records in YYYY-MM-DD format.

twilio_usage_records_today # Retrieve today's usage records for a Twilio account, optionally filtered by category. 1 param ▾

Retrieve today's usage records for a Twilio account, optionally filtered by category.

Name Type Required Description

category string optional The usage category to filter by (e.g., sms, calls, phonenumbers).

twilio_verification_get # Retrieve the status and details of a specific verification by its SID. 2 params ▾

Retrieve the status and details of a specific verification by its SID.

Name Type Required Description

service_sid string required The SID of the Verify service.

verification_sid string required The SID of the verification to retrieve.

twilio_verify_service_create # Create a new Twilio Verify service for sending verification codes via SMS, call, email, or WhatsApp. 5 params ▾

Create a new Twilio Verify service for sending verification codes via SMS, call, email, or WhatsApp.

Name Type Required Description

friendly_name string required A descriptive name for the Verify service.

code_length integer optional The length of the verification code to generate. Must be between 4 and 10.

lookup_enabled string optional Whether to perform a lookup on the phone number before sending verification.

psd2_enabled string optional Whether to enable PSD2 compliance for the service.

skip_sms_to_landlines string optional Whether to skip sending SMS to landline phone numbers.

twilio_verify_service_delete # Delete a Twilio Verify service by its SID. This action is irreversible. 1 param ▾

Delete a Twilio Verify service by its SID. This action is irreversible.

Name Type Required Description

service_sid string required The unique SID of the Verify service to delete.

twilio_verify_service_get # Retrieve details of a specific Twilio Verify service by its SID. 1 param ▾

Retrieve details of a specific Twilio Verify service by its SID.

Name Type Required Description

service_sid string required The unique SID of the Verify service to retrieve.

twilio_verify_services_list # List all Twilio Verify services on the account. 1 param ▾

List all Twilio Verify services on the account.

Name Type Required Description

page_size integer optional Number of results to return per page. Maximum is 1000.