Twilio REST API
Browse all Twilio APIs✓ Official Vendor SpecCommunicationsSms Messagingbasic197 EndpointsREST
For Agents
Send SMS/MMS messages, make voice calls, purchase phone numbers, and manage call recordings programmatically across 180+ countries.
Use for: I need to send an SMS message to a phone number, I want to initiate an outbound voice call with a greeting, List all available phone numbers in a specific country, Check whether an SMS was delivered successfully
Not supported: Does not handle email delivery, push notifications, or video — use for SMS, voice calls, and phone number management only.
Send and receive SMS and MMS messages, initiate and control voice calls, manage phone numbers, and handle conference calls across 180+ countries. Provides programmable communication building blocks including call recordings, transcriptions, SIP trunking, and queue management. Supports both domestic and international messaging with media attachments and delivery status callbacks.
Install Jentic One Beta
Connect the Twilio REST API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Twilio REST API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Twilio REST API.
Send SMS and MMS messages to mobile numbers worldwide with delivery status tracking
Initiate outbound voice calls with TwiML-based call flow control and recording
Purchase and configure phone numbers across 180+ countries with local, mobile, and toll-free options
Record and transcribe voice calls with configurable recording channels and formats
Bridge multiple call participants into conference rooms with mute and hold controls
Manage SIP domains and credential lists for enterprise voice infrastructure
Queue incoming calls with position announcements and custom hold music
Use Cases
Patterns agents use Twilio REST API for, with concrete tasks.
★ AI Agent SMS Notifications
AI agents send SMS notifications through Jentic by searching for the send message operation, loading the schema, and executing with To, From, and Body fields. Jentic handles Basic auth credential injection from the MAXsystem vault so agents never handle Account SID or Auth Token directly. A single POST to /2010-04-01/Accounts/{AccountSid}/Messages.json delivers the message with optional media URLs and status callback.
Send an SMS to +15551234567 from +15559876543 with body 'Your order has shipped' and verify the message SID is returned in the response
Automated Voice Calls
Trigger outbound voice calls for appointment reminders, security alerts, or customer callbacks. The API initiates the call and directs it to a TwiML document that defines the call flow — text-to-speech greetings, menu options, recordings, or forwarding. Status callbacks report call progress from initiated through completed, enabling retry logic for unanswered calls.
Initiate a voice call to +15551234567 using a TwiML URL that plays a text-to-speech appointment reminder and check the call status via GET /2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json
Phone Number Provisioning
Search and purchase local, mobile, or toll-free phone numbers in 180+ countries for SMS and voice capabilities. Filter available numbers by area code, country, and capabilities (SMS, MMS, voice, fax). Purchased numbers are immediately available for sending and receiving messages or calls, with configurable webhook URLs for inbound traffic routing.
Search for available toll-free numbers in the US via GET /2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/US/TollFree.json and purchase the first result
Call Recording and Transcription
Record voice calls for compliance, quality assurance, or training purposes. Recordings can capture both legs of a call or a single channel. Completed recordings are accessible via the API for playback or download. Transcription converts recorded audio to text, enabling search and analysis of call content without manual review.
Start a recording on an active call via POST /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json and retrieve the completed recording URI
Key Endpoints
197 endpoints — send and receive sms and mms messages, initiate and control voice calls, manage phone numbers, and handle conference calls across 180+ countries.
METHOD
PATH
DESCRIPTION
POST
/2010-04-01/Accounts/{AccountSid}/Messages.json
Send an SMS or MMS message
GET
/2010-04-01/Accounts/{AccountSid}/Messages/{Sid}.json
Retrieve a message by SID
POST
/2010-04-01/Accounts/{AccountSid}/Calls.json
Initiate an outbound voice call
GET
/2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json
Get call details and status
POST
/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json
Start recording a call
GET
/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{CountryCode}/Local.json
Search available local phone numbers
GET
/2010-04-01/Accounts/{AccountSid}/Balance.json
Get current account balance
POST
/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants/{CallSid}.json
Update a conference participant
POST
/2010-04-01/Accounts/{AccountSid}/Messages.json
Send an SMS or MMS message
GET
/2010-04-01/Accounts/{AccountSid}/Messages/{Sid}.json
Retrieve a message by SID
POST
/2010-04-01/Accounts/{AccountSid}/Calls.json
Initiate an outbound voice call
GET
/2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json
Get call details and status
POST
/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json
Start recording a call
GET
/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{CountryCode}/Local.json
Search available local phone numbers
GET
/2010-04-01/Accounts/{AccountSid}/Balance.json
Get current account balance
POST
/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants/{CallSid}.json
Update a conference participant
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Twilio Account SID and Auth Token are stored encrypted in the Jentic vault (MAXsystem). Agents receive pre-authenticated requests — raw credentials never enter the agent context or appear in logs.
Intent-based discovery
Agents search by intent (e.g., 'send an SMS message') and Jentic returns matching Twilio operations with their input schemas and required parameters, so the agent can call the correct endpoint without navigating 197 endpoints manually.
Time to first call
Direct Twilio integration: 2-4 days for auth setup, number provisioning, webhook configuration, and error handling. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Twilio REST API through Jentic.
What authentication does the Twilio REST API use?
The Twilio REST API uses HTTP Basic authentication with your Account SID as the username and Auth Token as the password. Through Jentic, these credentials are stored encrypted in the MAXsystem vault and injected automatically into the Basic auth header, so agents never handle the raw Account SID or Auth Token.
Can I send MMS messages with images through the Twilio API?
Yes. Include a MediaUrl parameter in your POST to /2010-04-01/Accounts/{AccountSid}/Messages.json pointing to a publicly accessible image URL. The API supports up to 10 media URLs per message for images, GIFs, and other supported MIME types.
What are the rate limits for sending SMS with Twilio?
Long code numbers support 1 SMS per second in the US. Toll-free numbers support up to 3 messages per second. Short codes can send 30-100 messages per second depending on the carrier. The API returns HTTP 429 when limits are exceeded, and messages are queued for retry.
How do I send an SMS through Jentic with the Twilio API?
Search for 'send an SMS message' in Jentic to find the Twilio Messages endpoint. Load the operation schema, then execute with To (recipient number), From (your Twilio number), and Body (message text). Install with pip install jentic and use the search-load-execute pattern. Jentic handles Basic auth injection automatically. Get started at https://app.jentic.com/sign-up.
Can I check whether an SMS was delivered?
Yes. Retrieve the message via GET /2010-04-01/Accounts/{AccountSid}/Messages/{Sid}.json and check the Status field. Values include queued, sending, sent, delivered, and failed. You can also configure a StatusCallback URL in the send request to receive real-time delivery webhooks.
How many countries does Twilio support for phone numbers?
Twilio offers phone numbers in 180+ countries. Use GET /2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers.json to list supported countries, then filter by country code and number type (local, mobile, toll-free) to find available numbers for purchase.
GET STARTED