Twilio

Get details of the current Twilio account. Args: - format: Response format ('json' or 'markdown') Returns: Account details including status, type, and friendly name.

Update the current Twilio account settings. Args: - friendlyName: (Optional) New friendly name for the account - status: (Optional) Account status - 'active', 'suspended', or 'closed' Returns: The updated account object.

List all subaccounts under the main account. Args: - format: Response format ('json' or 'markdown') Returns: List of subaccounts with their details.

Create a new subaccount under the main account. Subaccounts allow you to segment usage, phone numbers, and billing. Args: - friendlyName: A descriptive name for the subaccount Returns: The created subaccount object with its own SID and auth token.

Make an outbound phone call via Twilio. Args: - to: Destination phone number in E.164 format - from: Your Twilio phone number in E.164 format - url: (Optional) TwiML URL for call instructions - twiml: (Optional) Inline TwiML for call instructions - timeout: (Optional) Seconds to wait for answer (default: 60) - record: (Optional) Whether to record the call - machineDetection: (Optional) 'Enable' or 'DetectMessageEnd' for AMD - statusCallback: (Optional) URL for call status webhooks Note: Either 'url' or 'twiml' must be provided. Returns: The created call object with SID and status.

List voice calls from your Twilio account. Args: - to: (Optional) Filter by destination number - from: (Optional) Filter by caller number - status: (Optional) Filter by status (queued, ringing, in-progress, completed, busy, failed, no-answer, canceled) - startTimeAfter: (Optional) Filter calls started after this date (YYYY-MM-DD) - startTimeBefore: (Optional) Filter calls started before this date - pageSize: Number of calls to return (default: 20, max: 1000) - format: Response format ('json' or 'markdown') Returns: Paginated list of calls.

Get details of a specific call by SID. Args: - callSid: The call SID (starts with CA) - format: Response format ('json' or 'markdown') Returns: The call object with all details.

Modify an in-progress call or cancel a queued call. Args: - callSid: The call SID to modify - status: (Optional) Set to 'canceled' or 'completed' to end the call - url: (Optional) New TwiML URL for call instructions - twiml: (Optional) New inline TwiML Returns: The updated call object.

List all conversations in your account. Args: - format: Response format ('json' or 'markdown') Returns: List of conversations with their details.

Create a new conversation. Args: - friendlyName: (Optional) A descriptive name - uniqueName: (Optional) A unique identifier - messagingServiceSid: (Optional) Messaging Service for SMS participants - state: (Optional) Initial state - 'active', 'inactive', or 'closed' Returns: The created conversation object.

Get details of a specific conversation. Args: - conversationSid: The conversation SID (starts with CH) - format: Response format ('json' or 'markdown') Returns: The conversation object with all details.

Update a conversation. Args: - conversationSid: The conversation SID to update - friendlyName: (Optional) New descriptive name - uniqueName: (Optional) New unique identifier - state: (Optional) New state - 'active', 'inactive', or 'closed' Returns: The updated conversation object.

Delete a conversation. WARNING: This will delete all messages and participants. Args: - conversationSid: The conversation SID to delete Returns: Confirmation of deletion.

List participants in a conversation. Args: - conversationSid: The conversation SID - format: Response format ('json' or 'markdown') Returns: List of participants in the conversation.

Redact the body of a message (set to empty for compliance). Args: - messageSid: The message SID to redact Returns: The updated message with redacted body.

Add a participant to a conversation. Args: - conversationSid: The conversation SID - identity: (Optional) Chat user identity - messagingBindingAddress: (Optional) SMS participant phone number - messagingBindingProxyAddress: (Optional) Twilio phone for SMS proxy For SMS participants, provide both messagingBindingAddress and messagingBindingProxyAddress. For chat participants, provide identity. Returns: The created participant object.

Remove a participant from a conversation. Args: - conversationSid: The conversation SID - participantSid: The participant SID to remove Returns: Confirmation of removal.

List messages in a conversation. Args: - conversationSid: The conversation SID - format: Response format ('json' or 'markdown') Returns: List of messages in the conversation.

Send a message to a conversation. Args: - conversationSid: The conversation SID - body: The message text - author: (Optional) Message author identity Returns: The created message object.

Look up information about a phone number. Args: - phoneNumber: Phone number to lookup (E.164 or national format) - fields: (Optional) Data packages to include: - 'line_type_intelligence': Carrier and line type info - 'caller_name': Caller ID name (US only) - 'sim_swap': Recent SIM swap detection - 'call_forwarding': Call forwarding status - 'sms_pumping_risk': SMS fraud risk score - 'reassigned_number': Number reassignment check - countryCode: (Optional) Country code for national format numbers - format: Response format ('json' or 'markdown') Note: Some fields incur additional charges. Basic validation is free. Returns: Phone number details with requested intelligence data.

Validate a phone number format (free operation). Args: - phoneNumber: Phone number to validate - countryCode: (Optional) Country code for national format numbers - format: Response format ('json' or 'markdown') Returns: Validation result with E.164 and national format.

Get line type and carrier information for a phone number. Args: - phoneNumber: Phone number to lookup - format: Response format ('json' or 'markdown') Returns: Line type (mobile, landline, VoIP, etc.) and carrier details.

Check if a phone number has SMS pumping fraud risk. Args: - phoneNumber: Phone number to check - format: Response format ('json' or 'markdown') Returns: SMS pumping risk score and carrier risk category.

Send an SMS or MMS message via Twilio. Args: - to: Destination phone number in E.164 format (e.g., +15551234567) - from: Your Twilio phone number in E.164 format - body: The message text - mediaUrl: (Optional) URL(s) of media to send (for MMS) - messagingServiceSid: (Optional) Messaging Service SID instead of from number - statusCallback: (Optional) URL to receive status webhooks Returns: The created message object with SID and status.

List SMS/MMS messages from your Twilio account. Args: - to: (Optional) Filter by destination number - from: (Optional) Filter by sender number - dateSent: (Optional) Filter by date sent (YYYY-MM-DD) - pageSize: Number of messages to return (default: 20, max: 1000) - format: Response format ('json' or 'markdown') Returns: Paginated list of messages.

Get details of a specific message by SID. Args: - messageSid: The message SID (starts with SM or MM) - format: Response format ('json' or 'markdown') Returns: The message object with all details.

Delete a message from your account. Args: - messageSid: The message SID to delete Returns: Confirmation of deletion.

List all phone numbers in your Twilio account. Args: - format: Response format ('json' or 'markdown') Returns: List of your Twilio phone numbers with capabilities and configuration.

Get details of a specific phone number by SID. Args: - phoneNumberSid: The phone number SID (starts with PN) - format: Response format ('json' or 'markdown') Returns: The phone number object with all configuration details.

Search for available phone numbers to purchase. Args: - countryCode: ISO country code (e.g., 'US', 'GB', 'CA') - type: Number type - 'Local', 'TollFree', or 'Mobile' - areaCode: (Optional) Filter by area code - contains: (Optional) Pattern to match (e.g., '*FLOWERS*') - smsEnabled: (Optional) Filter by SMS capability - mmsEnabled: (Optional) Filter by MMS capability - voiceEnabled: (Optional) Filter by voice capability - inRegion: (Optional) Filter by state/region - inPostalCode: (Optional) Filter by postal code - nearNumber: (Optional) Find numbers near this number - pageSize: Number of results (default: 20) Returns: List of available phone numbers matching criteria.

Purchase a phone number for your account. Args: - phoneNumber: The phone number to purchase in E.164 format - friendlyName: (Optional) A descriptive name for the number - voiceUrl: (Optional) URL to fetch TwiML for incoming calls - smsUrl: (Optional) URL to fetch TwiML for incoming SMS - statusCallback: (Optional) URL for status webhooks Returns: The purchased phone number object.

Update configuration for a phone number. Args: - phoneNumberSid: The phone number SID to update - friendlyName: (Optional) New descriptive name - voiceUrl: (Optional) New TwiML URL for calls - voiceFallbackUrl: (Optional) Fallback TwiML URL - smsUrl: (Optional) New TwiML URL for SMS - smsFallbackUrl: (Optional) Fallback SMS URL - statusCallback: (Optional) New status webhook URL Returns: The updated phone number object.

Release (delete) a phone number from your account. WARNING: This action cannot be undone. The number will be released back to the pool. Args: - phoneNumberSid: The phone number SID to release Returns: Confirmation of release.

List voice recordings from your account. Args: - callSid: (Optional) Filter by call SID - conferenceSid: (Optional) Filter by conference SID - dateCreatedAfter: (Optional) Filter recordings after date (YYYY-MM-DD) - dateCreatedBefore: (Optional) Filter recordings before date - pageSize: Number of recordings to return (default: 20, max: 1000) - format: Response format ('json' or 'markdown') Returns: Paginated list of recordings.

Get details of a specific recording. Args: - recordingSid: The recording SID (starts with RE) - format: Response format ('json' or 'markdown') Returns: The recording object with details and media URL.

Delete a recording from your account. WARNING: This action cannot be undone. Args: - recordingSid: The recording SID to delete Returns: Confirmation of deletion.

Get usage records for your Twilio account. Args: - category: (Optional) Filter by category: - 'calls': Voice calls - 'sms': SMS messages - 'mms': MMS messages - 'phonenumbers': Phone number charges - 'recordings': Recording storage - 'transcriptions': Transcription charges - 'totalprice': Total charges (Many more categories available) - startDate: (Optional) Start date for usage period (YYYY-MM-DD) - endDate: (Optional) End date for usage period - includeSubaccounts: (Optional) Include subaccount usage - pageSize: Number of records to return (default: 20) - format: Response format ('json' or 'markdown') Returns: Usage records with counts, usage amounts, and prices.

Get SMS usage records for your account. Args: - startDate: (Optional) Start date (YYYY-MM-DD) - endDate: (Optional) End date (YYYY-MM-DD) - format: Response format ('json' or 'markdown') Returns: SMS usage with count and pricing.

Get voice call usage records for your account. Args: - startDate: (Optional) Start date (YYYY-MM-DD) - endDate: (Optional) End date (YYYY-MM-DD) - format: Response format ('json' or 'markdown') Returns: Voice usage with minutes and pricing.

Get total usage and costs for your account. Args: - startDate: (Optional) Start date (YYYY-MM-DD) - endDate: (Optional) End date (YYYY-MM-DD) - includeSubaccounts: (Optional) Include subaccount usage - format: Response format ('json' or 'markdown') Returns: Total usage across all categories with pricing.

Send a verification code to a phone number or email. Args: - serviceSid: Verify Service SID (starts with VA) - to: Destination phone number (E.164) or email address - channel: Delivery channel - 'sms', 'call', 'email', or 'whatsapp' - locale: (Optional) Locale for message (e.g., 'en', 'es', 'fr') - customCode: (Optional) Custom verification code (if enabled) Returns: The verification object with SID and status.

Check a verification code submitted by a user. Args: - serviceSid: Verify Service SID - to: Phone number or email that was verified - code: The verification code to check Returns: Verification check result with valid/invalid status.

List all Verify Services in your account. Args: - format: Response format ('json' or 'markdown') Returns: List of Verify Services with configurations.

Create a new Verify Service. Args: - friendlyName: A descriptive name for the service - codeLength: (Optional) Length of verification code (4-10, default: 6) - lookupEnabled: (Optional) Enable phone number lookup - skipSmsToLandlines: (Optional) Skip SMS for landlines, use voice - customCodeEnabled: (Optional) Allow custom verification codes Returns: The created Verify Service object.

Get details of a Verify Service. Args: - serviceSid: The Verify Service SID - format: Response format ('json' or 'markdown') Returns: The Verify Service object with configuration.

Delete a Verify Service. WARNING: This will delete all verification data for this service. Args: - serviceSid: The Verify Service SID to delete Returns: Confirmation of deletion.