NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #793 most downloaded on PyPI
Twilio API client and TwiML generator
Last release 6 days ago
28 Sep 2026
Release timing varies
gaps range from 2 weeks to 3 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
5 versions withdrawn
withdrawn after publishing
17 years old
370 releases · first in 2009
Add Service Webhook Configuration resource
Conversations
Service Webhook Configuration resourceFlex
flex_insights_drilldown and flex_url objects to Flex ConfigurationMessaging
Supersim
Verify
factor_friendly_name parameter to the create access token endpoint.Video
Twiml
<emphasis>, <lang>, <p>, <prosody>, <s>, and <w>.<emphasis>, <lang>, <p>, <prosody>, <s>, and <w>.One column per quarter.
PR #578: git log retrieval issues. Thanks to @shwetha-manvinkurke!
Library - Fix
Frontline
is_available to User's resourceMessaging
Verify
WHATSAPP to the attempts API.config.notification_platform from none to apn or fcm and viceversa for Verify Pushnone as a valid config.notification_platform value for Verify PushTwiml
<emphasis>, <lang>, <p>, <prosody>, <s>, and <w>.Added a new enum for brand registration status named DELETED (breaking change)
Library - Chore
Api
media_url property to be treated as PIIMessaging
Serverless
Verify
config.notification_token parameter.TemplateCustomSubstitutions on verification creationTemplateSid parameter public for Verification resource and DefaultTemplateSid parameter public for Service resource. (breaking change)Corrected enum values for emergency_address_status values in /IncomingPhoneNumbers response. (breaking change)
Library - Feature
Api
emergency_address_status values in /IncomingPhoneNumbers response. (breaking change)emergency_address_status values in /IncomingPhoneNumbers response.Messaging
Video
AudioOnly to create roomAdd If-Match Header based on ETag for Worker Delete (breaking change)
Api
emergency_address_status attribute to /IncomingPhoneNumbers response.siprec resourceConversations
NewMessage type of push notificationsFlex
flex_insights_hr object to Flex ConfigurationNumbers
Serverless
Taskrouter
If-Match Header based on ETag for Worker Delete (breaking change)If-Match Header based on Etag for Reservation UpdateIf-Match Header based on ETag for Worker UpdateIf-Match Header based on ETag for Worker DeleteETag as Response Header to WorkerTrunking
transfer_caller_id property on Trunks.Verify
whatsapp channel.Note: This release contains breaking changes, check our upgrade guide for detailed migration notes.
Note: This release contains breaking changes, check our upgrade guide for detailed migration notes.
Library - Fix
Library - Docs
Events
Messaging
Add 'mock' as an optional field to brand_registration api
Api
siprec resourcesiprec resourceMessaging
Verify
Add Programmabled Voice SIP Refer call transfers (calls-transfers) to usage records
Api
calls-transfers) to usage recordsflex-usage) to usage recordsConversations
Order query parameter to Message resource read operationInsights
partial to enum processing_state_requestMessaging
Pricing
Verify
TemplateSid optional parameter on Verification creation.Order to the list Challenges endpoint to define the list order.Corrected the price, call_sid_to_coach, and uri data types for Conference, Participant, and Recording (breaking change)
Library - Fix
Library - Chore
Api
price, call_sid_to_coach, and uri data types for Conference, Participant, and Recording (breaking change)time_limit in the call api public. (breaking change)domain_sid in sip_credential_list_mapping and sip_ip_access_control_list_mapping APIs (breaking change)Insights
Messaging
Taskrouter
X-Rate-Limit-Limit, X-Rate-Limit-Remaining, and X-Rate-Limit-Config as Response Headers to all TaskRouter endpointsVerify
TemplateSid optional parameter on Verification creation.whatsapp as a channel type in the verifications API.Expose ParticipantConversations resource
Conversations
Taskrouter
links to the activity resourceVerify
Version to Verify Factors Webhooks to add new fields without breaking old Webhooks.Changed last_read_message_index and unread_messages_count type in User Conversation's resource (breaking change)
Conversations
last_read_message_index and unread_messages_count type in User Conversation's resource (breaking change)Messaging
Update transcribe & transcription_configuration form params in Reservation update endpoint to have private visibility (breaking change)
Conversations
bindingSupersim
Taskrouter
transcribe & transcription_configuration form params in Reservation update endpoint to have private visibility (breaking change)transcribe & transcription_configuration form params to Reservation update endpointTwiml
modify event to statusCallbackEvent for <Conference>.Corrected the sid for policy sid in customer_profile_evaluation.json and trust_product_evaluation.json (breaking change)
Api
status enum for Messages to include 'canceled'update_status enum for Messages to include 'canceled'Trusthub
join Sinks and Subscriptions service
Events
Verify
challenge adding the maximum and minimum expected lengths of some fields.notification by updating the documentation of the field ttl.Add fetch and delete instance endpoints to us_app_to_person api (breaking change)
Events
Messaging
sid field to Preregistered US App To Person responseSupersim
unique_name in Sim, Fleet, NAP resources as not PIIVideo
Corrected the data types for feedback summary fields (breaking change)
Api
from and to param to be endpoint type for supporting client identifier and sip addressBulkexports
Events
Messaging
status field in us_app_to_person api to campaign_status (breaking change)Verify
push factor and include extra information about totp factor.Change schema_versions prop and key to versions (breaking change)
Api
from and to param to be endpoint type for supporting client identifier and sip addressfrom and to param to be endpoint type for supporting client identifier and sip addressBulkexports
Events
Messaging
use_inbound_webhook_on_number field in Service API for fetch, create, update, readTaskrouter
If-Match Header based on ETag for Task DeleteVerify
AuthPayload parameter to support verifying a Challenge upon creation. This is only supported for totp factors.Challenge. This is only supported for push factors.Twiml
Removed optional property time_limit in the call create request. (breaking change)
Api
announcement event to conference status callback eventstime_limit in the call create request. (breaking change)Messaging
Supersim
Verify
Binding field is now returned when creating a Factor. This value won't be returned for other endpoints.Video
Twiml
announcement event to statusCallbackEvent for <Conference>.Recording rule beta flag (breaking change)
Api
CallToken for create calls apitime_limit in the call create request.Bulkexports
Events
Numbers
Supersim
SmsCommandsUrl, SmsCommandsMethod and SmsCommandsEnabled to a Fleet resourceTaskrouter
If-Match Header based on ETag for Task UpdateETag as Response Headers to Tasks and ReservationsVideo
Adjust A2P brand registration status enum (breaking change)
Library - Chore
Events
Messaging
Studio
Verify
api.verify.totp beta feature.Twiml
<VirtualAgent> nounRemove A2P campaign and use cases API (breaking change)
Library - Chore
Events
Messaging
Trusthub
Verify
Remove If-Match header for Document (breaking change)
Library - Docs
Library - Fix
Api
from and to param to be endpoint type for supporting client identifier and sip addressfrom and to param to be endpoint type for supporting client identifier and sip addressEvents
Flex
notifications and markdown to Flex ConfigurationMessaging
Serverless
Sync
Twiml
refer_url and refer_method to Dial.Allow updating CommandsUrl and CommandsMethod on a Fleet
Studio
Supersim
CommandsUrl and CommandsMethod on a FleetTwiml
status_callback and status_callback_method to Stream.Changed last_read_message_index type in Participant's resource (breaking change)
Library - Docs
Library - Fix
Api
Conversations
last_read_message_index type in Participant's resource (breaking change)Insights
created_time to call summary.Sync
Video
Updated call_event default_output_properties to request and response.
Api
call_event default_output_properties to request and response.Conversations
last_read_message_index and last_read_timestamp to Participant's resource update operationis_notifiable and is_online to User's resourcereachability_enabled parameters to update method for Conversation Service Configuration resourceMessaging
Twiml
sequential to Dial.Removed deprecated Programmable Chat usage record categories (breaking change)
Api
RecordingTrack parameter for create calls, create participants, and create call recordingsTwiml
recordingTrack to Dial.Remove RecordingTrack parameter for create calls, create participants, and create call recordings (breaking change)
Library - Feature
Api
RecordingTrack parameter for create calls, create participants, and create call recordings (breaking change)RecordingTrack parameter for create calls and create call recordingsrecording_track in the participant create requestLookups
caller_name and carrier properties type to object (breaking change)Trunking
Twiml
jitterBufferSize and participantLabel to Conference.Removing call_sid from participant summary. (breaking change)
Api
Conversations
Insights
Serverless
Sync
Verify
Details and HiddenDetails properties are now marked as PIIexpiration_date attribute updated to set a default value of five (5) minutes and to allow max dates of one (1) hour after creation.identity attribute updated to allow values between 8 and 64 characters.The API itself failed the request without these fields. (breaking change)
Library - Docs
Api
verify-push to usage_record APIBulkexports
Insights
Ip_messaging
Verify
preview to betatwilio_sandbox_mode header was removed from Verify Push resources (breaking change)Video
Simplified Channels resource. The path is now /BrandedChannels/branded_channel_sid/Channels (breaking change)
Library - Docs
Ai
Annotation Project and Annotation Task endpointsPrimitives endpointsmeta.total to the search endpointConversations
Insights
trust to summary.Preview
Channels resource. The path is now /BrandedChannels/branded_channel_sid/Channels (breaking change)Verify
config and binding) to use dot notation instead of JSON string (e.i. Before: binding={"alg":"ES256", "public_key": "xxx..."}, Now: Binding.Alg="ES256", Binding.PublicKey="xxx..."). (breaking change)details and hidden_details) to use dot notation instead of JSON string (e.i. Before: details={"message":"Test message", "fields": "[{\"label\": \"Action 1\", \"value\":\"value 1\"}]"}, Now: details.Message="Test message", Details.Fields=["{\"label\": \"Action 1\", \"value\":\"value 1\"}"]). (breaking change)notify_service_sid from push service configuration object. Add Push.IncludeDate, Push.ApnCredentialSid and Push.FcmCredentialSid service configuration parameters. (breaking change)PR #541: Fix pip download link. Thanks to @swarnava!
Library - Docs
Api
call_reason in the participant create requestMessaging
Serverless
Video
PR #540: allow API redirect responses. Thanks to @childish-sambino!
Library - Fix
Accounts
Conversations
Events
Expose Configuration and Service Configuration resources
Conversations
Messaging
Numbers
Proxy
Supersim
AccountSid parameter to Sim resource update requestready status as an available status for a Sim resourcePR #538: convert markdown links to rst formatted links. Thanks to @thinkingserious!
Library - Docs
Ai
Bulkexports
Messaging
Numbers
Routes
Trunking
transfer_mode property on Trunks.Removed Start and End parameters from the Data Sessions list endpoint. (breaking change)
Library - Chore
Conversations
Events
Proxy
Supersim
Wireless
Start and End parameters from the Data Sessions list endpoint. (breaking change)Add rejection reason support to WhatsApp API
Messaging
Proxy
Verify
CustomFriendlyName optional parameter on Verification creation.Challenge resource to update documentation of both details and hidden_details properties.Add optional Click Tracking and Scheduling parameters to Create action of Message resource
Api
Supersim
Changed wfm_integrations Flex Configuration key to private (breaking change)
Library - Feature
Conversations
Events
Flex
wfm_integrations Flex Configuration key to private (breaking change)Messaging
Numbers
valid_until in the Bundles resourceVerify
sms, totp and app-push factor types in Verify push (breaking change)Update start/end date filter params to support date-or-time format (breaking change)
Api
JitterBufferSize parameter for creating conference participantlabel property for conference participantscaller_id for creating conference participant endpoint.Autopilot
Conversations
Monitor
Numbers
provisionally-approved as a Supporting Document statusPreview
Authy resources. (breaking change)Supersim
Verify
api.verify.push beta featureTwiml
Gather verb.Removed insights preview API from API Definitions (breaking change)
Library - Docs
Library - Fix
Api
pstnconnectivity to usage_record APIAutopilot
Notify
Numbers
provisionally-approved as a Bundle statusPreview
BrandsInformation endpoint now returns a single BrandsInformationkyc-apipreview API from API Definitions (breaking change)BrandsInformation endpoint to query brands information stored in KYCSupersim
Renamed twilio_authy_sandbox_mode headers to twilio_sandbox_mode (breaking change)
Api
reason_conference_ended and call_sid_ending_conference to Conference read/fetch/updateAuthy
twilio_authy_sandbox_mode headers to twilio_sandbox_mode (breaking change)Twilio-Authy-* headers to Twilio-Veriry-* (breaking change)Flex
flex_service_instance_sid to Flex ConfigurationPreview
Channels endpoint to brand a phone number for BrandedCallsServerless
Supersim
Trunking
PR #520: add regional and edge support. Thanks to @eshanholtz!
Library - Feature
Api
emergency_caller_sid parameter to SIP Domaincall_reason optional property to be treated as PIIAutopilot
Contacts
Events
Numbers
Supersim
Verify
CustomCode optional parameter on Verification creation.Voice
PR #517: add details to TwilioRestException. Thanks to @ashish-s!
PR #513: remove S3 URLs from test data. Thanks to @childish-sambino!
Library - Chore
Api
call_reason in the call create requestContacts
Studio
flow_valid to flow_validateerrors and warnings from flows error response and added new property named detailswarnings attribute v2 flow POST apiTwiml
speech_model for the Gather verbRemove deactivated status for Super SIM which is replaced by inactive (breaking change)
Api
Authy
Push when updating a service to send the service level push factor configurationBulkexports
Flex
queue_stats_configuration and wfm_integrations to Flex ConfigurationServerless
Supersim
deactivated status for Super SIM which is replaced by inactive (breaking change)Added config param to Factor creation (breaking change)
Api
emergency_calling_enabled parameter to SIP Domaincall_reason in the call create requestAuthy
friendly_name and config as optional params to Factor updateconfig param to Factor creation (breaking change)Preview
SuccessRate endpoint to ImpressionsRate for Branded Calls (fka. Verified by Twilio) (breaking change)Remove FactorStrength support for Factors and Challenges (breaking change)
Library - Feature
Authy
configuration property to services to return the service level configurationsPush when creating a service to send the service level push factor configurationMessaging
Preview
/Devices register Branded Calls endpoint, as per iOS sample app deprecation (breaking change)Twilio-Sandbox-Mode request header from the Branded Calls endpoints, as not officially supported (breaking change)Verify version from preview subdomain in favor to verify subdomain. (breaking change)Serverless
Supersim
inactive status for Super SIM which is an alias for deactivatedTaskrouter
priority in task endpointVerify
SendCodeAttempts type. It's an array of objects instead of a unique object. (breaking change)Deprecate Session API (breaking change)
Api
async_amd, async_amd_status_callback, and async_amd_status_callback_method publictrunk_sid as an optional field to Call resource fetch/read responsesqueue_time to successful response of create, fetch, and update requests for Callbyoc to conference participant create.Authy
Flex
ui_dependencies to Flex ConfigurationMessaging
Numbers
Studio
Taskrouter
longest_relative_task_age_in_queue and longest_relative_task_sid_in_queue to TaskQueue Real Time Statistics API.wait_duration_in_queue_until_accepted aggregations to TaskQueues Cumulative Statistics endpointVideo
audio_sources or the video_layout, but one of them has to be providedaudio_sources type on the composer HTTP POST command, changed from sid[] to string[] (breaking change)audio_sources or the video_layout, but one of them has to be providedMaking content retention and address retention public
Api
status enum for Messages to include 'partially_delivered'Authy
Autopilot
Verify
SendCodeAttempts to create verification response.Video
audio_sources or video_layout, but on of them has to be providedTwiml
Removed Verify v2 from preview in favor of its own namespace as GA (breaking change)
Library - Docs
Api
byoc to call create request.Flex
creation_on_message parameter documentationStudio
Verify
AppHash parameter when creating a Verification.DoNotShareWarningEnabled parameter to the Service resource.Twiml
track attribute to siprec noun.byoc to <Number>Add Regulatory Compliance CRUD APIs
Numbers
Studio
Twiml
speech_model to Gather verbAdd /Insights/SuccessRate endpoint for Businesses Branded Calls (Verified by Twilio)
Preview
/Insights/SuccessRate endpoint for Businesses Branded Calls (Verified by Twilio)Studio
Verify
MailerSid property to Verify Service resource.Wireless
data_limit_strategy to Rate Plan resource.Removed discard / obfuscate parameters from ContentRetention, AddressRetention (breaking change)
Library
Api
twiml conditional for create. One of url, twiml, or application_sid is now required.bundle_sid parameter to /IncomingPhoneNumbers APIChat
last_consumed_message_index and last_consumption_timestamp parameters in update method for UserChannel resource (breaking change)Conversations
Messaging
PR #501: BREAKING CHANGE feat: add custom HTTP header support. Thanks to @eshanholtz! (breaking change)
Library
Api
twiml parameter for call createChat
delete method in UserChannel resourceConversations
Taskrouter
Twiml
mixed_track value from <Stream> (breaking change)<Receive> optional attributesPR #495: Rename child twiml methods to be the tag name and deprecate old methods. Thanks to @eshanholtz!
Library
Api
persistent_action parameter publictwiml optional private parameter for call createAutopilot
Flex
channel_type options documentationInsights
Messaging
Supersim
Direction filter parameter to list commands endpointIccid filter parameter to list sims endpointTwiml
<Refer> verbImplemented different Sid for Current Calls (Verified by Twilio), instead of relying in Call.Sid from Voice API team (breaking change)
Library
Api
sms-messages-carrierfees and mms-messages-carrierfeesConversations
Preview
Sid for Current Calls (Verified by Twilio), instead of relying in Call.Sid from Voice API team (breaking change)Supersim
Wireless
account_sid to Sim update parameters.Twiml
Say from PollyPR #479: breaking: Correct video composition date types. Thanks to @childish-sambino! (breaking change)
Library
PhoneNumberInstance.carrier. Thanks to @NCPlayz!Api
attempt to sms_messagesFlex
JanitorEnabled attribute to Flex Flowfeatures_enabled Flex Configuration key to private (breaking change)Supersim
Twiml
<Conference> rename "whisper" attribute to "coach" (breaking change)PR #477: added validation of signature without stripping port number. Thanks to @eshanholtz!
Library
Conversations
Supersim
Changed authentication method for SDK Trusted Comms endpoints: /CPS, /CurrentCall, and /Devices. Please use Authorization: Bearer (breaking change)
Numbers
Preview
/CPS, /CurrentCall, and /Devices. Please use Authorization: Bearer <xCNAM JWT> (breaking change)Voice
Message API required params updated (breaking change)
Api
Conversations
Flex
features_enabled and serverless_service_sids to Flex ConfigurationMessaging
Preview
CallSid to /BrandedCalls endpointYour coding agent can read these notes before it upgrades. Set up the MCP server →