twilio-api_skill

Overview

This skill provides programmatic access to the public Twilio REST API so you can manage calls, messages, phone numbers, recordings, and account resources. It exposes the full set of Twilio resources and operations needed for voice, SMS, and telephony management. Use it to automate provisioning, send/receive messages, control calls, and fetch usage or billing data.

How this skill works

The skill calls Twilio's REST endpoints at https://api.twilio.com using account SID and auth token authentication. It surfaces resource-level operations (create, read, update, delete, list) for core objects such as Calls, Messages, IncomingPhoneNumbers, Recordings, Conferences, and more. When an operation references data models, the skill uses Twilio schemas to validate and format request and response payloads.

When to use it

• Automating SMS or MMS sending and delivery tracking
• Programmatically initiating, monitoring, or controlling voice calls and conferences
• Provisioning or releasing phone numbers and managing their routing
• Accessing call/recording transcriptions, media, and recordings
• Querying account usage, balance, keys, and security settings

Best practices

• Use account SID and auth token over HTTPS and rotate credentials regularly
• Paginate list responses and respect rate limits to avoid throttling
• Validate request payloads against expected schemas before sending
• Store and handle recordings and transcripts securely, complying with privacy rules
• Test actions in a sandbox or test account before running against production

Example use cases

• Send transactional SMS notifications from your application and track delivery status
• Create an outbound call, play dynamic TwiML instructions, and record the session
• Buy and configure a phone number, set webhooks for SMS and voice handling
• Download call recordings and generate transcriptions for quality assurance
• Automate user verification via voice or SMS OTP and log authentication events