Twilio Voice connects phone calls to workflows. Use this integration to place outbound calls, list calls, retrieve recordings, and receive call events through a webhook. Supply the call instructions and phone numbers required by the selected operation.
Make outbound calls, list calls, retrieve recordings, and receive call events through webhooks.
Make an outbound phone call using Twilio Voice API.
Inputs and outputsParameter Type Required Description tostring Yes Phone number to call in E.164 format (e.g., +14155551234) fromstring Yes Your Twilio phone number to call from in E.164 format (e.g., +14155559876) urlstring No Webhook URL that returns TwiML instructions for the call (e.g., https://example.com/twiml ) twimlstring No TwiML instructions to execute. Use square brackets instead of angle brackets (e.g., [Response][Say]Hello[/Say][/Response]) statusCallbackstring No Webhook URL for call status updates statusCallbackMethodstring No HTTP method for status callback (GET or POST) accountSidstring Yes Twilio Account SID authTokenstring Yes Twilio Auth Token recordboolean No Whether to record the call recordingStatusCallbackstring No Webhook URL for recording status updates timeoutnumber No Time to wait for answer before giving up (seconds, default: 60) machineDetectionstring No Answering machine detection: Enable or DetectMessageEnd
Parameter Type Description successboolean Whether the call was successfully initiated callSidstring Unique identifier for the call statusstring Call status (queued, ringing, in-progress, completed, etc.) directionstring Call direction (outbound-api) fromstring Phone number the call is from tostring Phone number the call is to durationnumber Call duration in seconds pricestring Cost of the call priceUnitstring Currency of the price errorstring Error message if call failed
Retrieve a list of calls made to and from an account.
Parameter Type Required Description accountSidstring Yes Twilio Account SID authTokenstring Yes Twilio Auth Token tostring No Filter by calls to this phone number in E.164 format (e.g., +14155551234) fromstring No Filter by calls from this phone number in E.164 format (e.g., +14155559876) statusstring No Filter by call status (e.g., queued, ringing, in-progress, completed, busy, failed, no-answer, canceled) startTimeAfterstring No Filter calls that started on or after this date (YYYY-MM-DD) startTimeBeforestring No Filter calls that started on or before this date (YYYY-MM-DD) pageSizenumber No Number of records to return (max 1000, default 50)
Parameter Type Description successboolean Whether the calls were successfully retrieved callsarray Array of call objects totalnumber Total number of calls returned pagenumber Current page number pageSizenumber Number of calls per page errorstring Error message if retrieval failed
Retrieve call recording information and transcription (if enabled via TwiML).
Parameter Type Required Description recordingSidstring Yes Recording SID to retrieve (e.g., RExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx) accountSidstring Yes Twilio Account SID authTokenstring Yes Twilio Auth Token
Parameter Type Description successboolean Whether the recording was successfully retrieved recordingSidstring Unique identifier for the recording callSidstring Call SID this recording belongs to durationnumber Duration of the recording in seconds statusstring Recording status (completed, processing, etc.) channelsnumber Number of channels (1 for mono, 2 for dual) sourcestring How the recording was created mediaUrlstring URL to download the recording media file filefile Downloaded recording media file pricestring Cost of the recording priceUnitstring Currency of the price uristring Relative URI of the recording resource transcriptionTextstring Transcribed text from the recording (if available) transcriptionStatusstring Transcription status (completed, in-progress, failed) transcriptionPricestring Cost of the transcription transcriptionPriceUnitstring Currency of the transcription price errorstring Error message if retrieval failed
A trigger starts a workflow when a supported event occurs in this service.
Trigger workflow when phone calls are received via Twilio Voice
Configuration and outputsParameter Type Required Description accountSidstring Yes Your Twilio Account SID from the Twilio Console authTokenstring Yes Your Twilio Auth Token for webhook signature verification twimlResponsestring No TwiML instructions to return immediately to Twilio. Use square brackets instead of angle brackets (e.g., [Response] instead of <Response>). This controls what happens when the call comes in (e.g., play a message, record, gather input). Your workflow will execute in the background.
Parameter Type Description callSidstring Unique identifier for this call accountSidstring Twilio Account SID fromstring Caller's phone number (E.164 format) tostring Recipient phone number (your Twilio number) callStatusstring Status of the call (queued, ringing, in-progress, completed, etc.) directionstring Call direction: inbound or outbound apiVersionstring Twilio API version callerNamestring Caller ID name if available forwardedFromstring Phone number that forwarded this call digitsstring DTMF digits entered by caller (from <Gather>) speechResultstring Speech recognition result (if using <Gather> with speech) recordingUrlstring URL of call recording if available recordingSidstring Recording SID if available calledstring Phone number that was called (same as "to") callerstring Phone number of the caller (same as "from") toCitystring City of the called number toStatestring State/province of the called number toZipstring Zip/postal code of the called number toCountrystring Country of the called number fromCitystring City of the caller fromStatestring State/province of the caller fromZipstring Zip/postal code of the caller fromCountrystring Country of the caller calledCitystring City of the called number (same as toCity) calledStatestring State of the called number (same as toState) calledZipstring Zip code of the called number (same as toZip) calledCountrystring Country of the called number (same as toCountry) callerCitystring City of the caller (same as fromCity) callerStatestring State of the caller (same as fromState) callerZipstring Zip code of the caller (same as fromZip) callerCountrystring Country of the caller (same as fromCountry) callTokenstring Twilio call token for authentication rawstring Complete raw webhook payload from Twilio as JSON string