NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #973 most downloaded on PyPI
Twilio API client and TwiML generator
Last release 7 days ago
10 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
369 releases · first in 2009
Add new APIs for vendor authorize and token endpoints
Mark brand_feedback attribute as deprecated.
Yanked
Library - Chore
Api
Flex
plugins visibility to publicMessaging
errors attribute to the Brand Registration resource.brand_feedback attribute as deprecated.failure_reason attribute as deprecated.errors attribute is expected to provide additional information about Brand registration failures and feedback (if any has been provided by The Campaign Registry). Consumers should use this attribute instead of brand_feedback and failure_reason.Numbers
Trusthub
Twiml
One column per quarter.
Note: This release contains breaking changes, check our upgrade guide for detailed migration notes.
Yanked
Note: This release contains breaking changes, check our upgrade guide for detailed migration notes.
Library - Feature
Library - Chore
Api
Flex
routing_properties to Interactions Channels ParticipantLookups
line_status package to the lookup responselive_activity package from the lookup response (breaking change)Messaging
Trusthub
Twiml
Say verbRemove carrier field from sms_pumping_risk and leave carrier_risk_category (breaking change)
Library - Chore
Flex
flex_instance_sid to Flex ConfigurationInsights
Lookups
carrier field from sms_pumping_risk and leave carrier_risk_category (breaking change)Messaging
Push
Trusthub
Verify
Tags property added again to Public Docs (breaking change)PR #743: sync with main. Thanks to @tiwarishubham635!
Updated service base url for connect apps and authorized connect apps APIs (breaking change)
Library - Fix
Library - Chore
Api
CallToken for create participant apiEvents
Flex
flex_instance_sid to Flex Configurationprovisioning_status for Email Manageroffline_config to Flex ConfigurationInsights
Intelligence
Lookups
carrier field from sms_pumping_risk and leave carrier_risk_category (breaking change)Messaging
Numbers
Push
Serverless
Taskrouter
jitter_buffer_size param in update reservationTrusthub
Verify
Tags property added again to Public Docs (breaking change)Tags from Public Docs (breaking change)VerifyEventSubscriptionEnabled parameter to service create and update endpoints.Tags optional parameter on Verification creation.updated openid discovery endpoint uri (breaking change)
Oauth
PR #749: removing webhook test. Thanks to @tiwarishubham635!
Library - Chore
Push
Updated service base url for connect apps and authorized connect apps APIs (breaking change)
Library - Chore
Api
Events
Insights
Numbers
Taskrouter
jitter_buffer_size param in update reservationTrusthub
Verify
Tags from Public Docs (breaking change)Add VerifyEventSubscriptionEnabled parameter to service create and update endpoints.
Verify
VerifyEventSubscriptionEnabled parameter to service create and update endpoints.PR #733: bumping aiohttp from 3.8.5 to 3.8.6. Thanks to @tiwarishubham635!
Library - Chore
Api
Messaging
Taskrouter
Trusthub
Verify
Tags optional parameter on Verification creation.Adding provisioning_status for Email Manager
Flex
provisioning_status for Email ManagerIntelligence
Messaging
Serverless
Verify
Deleted redacted parameter from fetching transcript in v2 (breaking change)
Library - Fix
Accounts
Api
CallToken for create participant apiFlex
offline_config to Flex ConfigurationIntelligence
redacted parameter from fetching transcript in v2 (breaking change)Lookups
phone_number_quality_score package to the lookup responsedisposable_phone_number_risk package (breaking change)Messaging
message_samples requirementsTaskrouter
virtual_start_time property to taskstask_queue_data format from map to array in the response of bulk get endpoint of TaskQueue Real Time Statistics API (breaking change)PR #721: Drop dependency on pytz by using stdlib datetime.timezone.utc. Thanks to @Zac-HD!
Introducing new channel status as inactive in modify channel endpoint for leave functionality (breaking change)
Conversations
Flex
console_errors_included to Flex Configuration field debugger_integrationsinactive in modify channel endpoint for leave functionality (breaking change)citrix_voice_vdi to Flex ConfigurationTaskrouter
Make message tagging parameters public (breaking change)
Api
Flex
agent_conv_end_methods to Flex ConfigurationMessaging
Numbers
Pricing
Changing sid path param to sid in interaction channel participant update endpoint (breaking change)
Library - Test
Api
RiskCheck for SMS pumping protection feature only (public beta to be available soon): Include this parameter with a value of disable to skip any kind of risk check on the respective message requestFlex
sid<UO> path param to sid<UT> in interaction channel participant update endpoint (breaking change)Messaging
Numbers
Remove Sms capability property from HNO creation under version /v2 of HNO API. (breaking change)
Library - Fix
Flex
interaction_context_sid as optional parameter in Interactions APIMessaging
Numbers
/v2 of HNO API. (breaking change)/v2 of Authorization document API. (breaking change)Taskrouter
Verify
RiskCheck optional parameter on Verification creation.Twiml
Update properties in Porting and Bulk Porting APIs. (breaking change)
Lookups
reassigned_number package to the lookup responseNumbers
/v2./v1./v1.Removed content_sid as optional field (breaking change)
Api
content_sid as conditional parametercontent_sid as optional field (breaking change)Insights
annotation to list summary outputAdd Trim to create Conference Participant API
Api
Trim to create Conference Participant APIIntelligence
Messaging
errors attribute to us_app_to_person resource. This attribute will provide additional information about campaign registration errors.Added AddressCountry parameter to Address Configuration endpoint, to support regional short code addresses
Conversations
AddressCountry parameter to Address Configuration endpoint, to support regional short code addressesstart_date, end_date and state in list Conversations resource for filteringInsights
Messaging
disable_https to link shortening domain_config propertiesNumbers
/v1.Remove start_date, end_date and state query parameters from list operation on Conversations resource (breaking change)
Conversations
start_date, end_date and state query parameters from list operation on Conversations resource (breaking change)Twiml
Say verbRemove messaging_service_sids and messaging_service_sid_action from domain config endpoint (breaking change)
Library - Chore
Library - Docs
Messaging
messaging_service_sids and messaging_service_sid_action from domain config endpoint (breaking change)Numbers
/v1.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 - Feature
Conversations
start_date, end_date and state in list operation on Conversations resource for sorting and filteringInsights
Lookups
disposable_phone_number_risk package (breaking change)Messaging
SOLE_PROPRIETOR brand type and SOLE_PROPRIETOR campaign use case.SOLE_PROPRIETOR brand type. Brand registration requests with STARTER brand type will be rejected.SOLE_PROPRIETOR campaign use case. Campaign registration requests with STARTER campaign use case will be rejected.Corrected the data type for friendly_name in Available Phone Number Local, Mobile and TollFree resources (breaking change)
Library - Docs
Library - Chore
Library - Fix
Library - Feature
Library - Test
Api
friendly_name in Available Phone Number Local, Mobile and TollFree resourcesfriendly_name in Available Phone Number Local, Mobile and TollFree resources (breaking change)scheduled_for property from message resourcescheduled_for property to message resourcepublic_application_connect_enabled param to Application resourceConversations
Lookups
validation_results from the default_output_propertiesdisposable_phone_number_risk package to the lookup responsesms_pumping_risk package to the lookup responseno_data to data_not_available in identity match packageMessaging
linkshortening_messaging_service resourcevalidated parameter and add cert_in_validation parameter to Link Shortening API (breaking change)Supersim
matching_id and activation_code parameters to librariesVerify
device_ip parameter and channel auto for sna/sms orchestrationTwiml
<Application> noun and <ApplicationSid> noun, nested <Parameter> to <Hangup> and <Leave> verbCorrected the data type for friendly_name in Available Phone Number Local, Mobile and TollFree resources (breaking change)
Api
friendly_name in Available Phone Number Local, Mobile and TollFree resourcesfriendly_name in Available Phone Number Local, Mobile and TollFree resources (breaking change)Messaging
linkshortening_messaging_service resourcevalidated parameter and add cert_in_validation parameter to Link Shortening API (breaking change)Add new categories for whatsapp template
Api
Lookups
validation_results from the default_output_propertiesSupersim
matching_id and activation_code parameters to librariesRemove scheduled_for property from message resource
Api
scheduled_for property from message resourcescheduled_for property to message resourceAdd disposable_phone_number_risk package to the lookup response
Lookups
disposable_phone_number_risk package to the lookup responsesms_pumping_risk package to the lookup responsePR #636: update tox config and replace deprecated test functions. Thanks to @childish-sambino!
Library - Chore
Library - Docs
Library - Test
Api
public_application_connect_enabled param to Application resourceMessaging
Verify
device_ip parameter and channel auto for sna/sms orchestrationTwiml
<Application> noun and <ApplicationSid> noun, nested <Parameter> to <Hangup> and <Leave> verbAdd support for creating Multi-Channel Rich Content Messages
Conversations
Lookups
no_data to data_not_available in identity match packageMessaging
Make method optional for user defined message subscription (breaking change)
Library - Docs
Library - Chore
Library - Test
Api
street_secondary param to address create and updatemethod optional for user defined message subscription (breaking change)Flex
Media
Messaging
MessageFlow as a required field for Campaign Creation (breaking change)Oauth
Supersim
statusTwiml
<lang> element.<phoneme> element.character value for SSML <say-as> interpret-as attribute to characters. (breaking change)role attribute to format in SSML <say-as> element. (breaking change)Adding new assessments api in version v1
Flex
assessments api in version v1Lookups
identity_match package to the lookup responseMessaging
validated parameter to Link Shortening APIServerless
PR #624: upgrade GitHub Actions dependencies. Thanks to @childish-sambino!
Library - Chore
Api
Flex
base_url to 'gooddata' response in version v1Insights
answered_by field in List Call Summaryanswered_by field in call summaryAdding two new authorization API 'user_roles' and 'gooddata' in version v1
Flex
v1Messaging
Twiml
Gather.Added contentSid and contentVariables to Message resource with public visibility as Beta
Api
contentSid and contentVariables to Message resource with public visibility as BetaUserDefinedMessageSubscription and UserDefinedMessage resourceProxy
Supersim
Taskrouter
Ordering query parameter to Workers and TaskQueues for sorting byworker_sid query param for list reservations endpointTwiml
url and method attributes to <Conversation>Make link shortening parameters public (breaking change)
Api
Oauth
Supersim
Verify
ga maturityTwiml
requireMatchingInputs attribute and input-matching-failed errorType to <Prompt>Added virtual-agent to usage_record API.
Api
virtual-agent to usage_record API.Twiml
Number and SipPR #617: support duplicated query param values. Thanks to @childish-sambino!
Library - Fix
Removed redundant close status from Flex Interactions flow (breaking change)
Library - Fix
Flex
close status from Flex Interactions flow (breaking change)debugger_integration and flex_ui_status_report to Flex ConfigurationMessaging
Verify
Video
Anonymize APITwiml
event value call-in-progress to call-answeredRemove beta feature from scheduling params and remove optimize parameters. (breaking change)
Library - Test
Api
beta feature from scheduling params and remove optimize parameters. (breaking change)Routes
Twiml
<lang>.Inbound Proccessing Region API - Public GA
Routes
Supersim
DataLimit on a FleetReorder Verification Check parameters so code stays as the first parameter (breaking change)
Flex
status, error_code, and error_message fields to Interaction Channelmessenger and gbm as supported channels for Interactions APIMessaging
Verify
code stays as the first parameter (breaking change)Allowed to use identity as part of Participant's resource (breaking change)
Library - Fix
Library - Test
Conversations
identity as part of Participant's resource (breaking change)Lookups
enhanced_line_type from the lookup response (breaking change)Supersim
sim_ip_addresses resource to helper librariesVerify
service_sid to verify_service_sid to be consistent with list attempts API (breaking change)code optional on Verification check to support sna attempts. (breaking change)Remove api.verify.totp beta flag and set maturity to beta for Verify TOTP properties and parameters. (breaking change)
Api
amazon-polly to usage_record API.Insights
annotation field in call summaryVerify
api.verify.totp beta flag and set maturity to beta for Verify TOTP properties and parameters. (breaking change)verify_service_sid to service_sid to be consistent with list attempts API (breaking change)Twiml
maxQueueSize to EnqueueAdding support for Lookup V2 API
Lookups
Studio
Twiml
statusCallbackMethod attribute, nested <Config and <Parameter> elements to <VirtualAgent> noun.Say verb<Conversation> nounPR #608: use Docker 'rc' tag for release candidate images. Thanks to @childish-sambino!
Library - Chore
PR #592: Respect HTTPS_PROXY and other settings from env vars. Thanks to @AlanCoding!
Library - Fix
Api
media_url to the recording resourcesVerify
silent as a channel type in the verifications API.Change ESimProfiles Eid parameter to optional to enable Activation Code download method support (breaking change)
Conversations
type in list operation on Address Configurations resourceSupersim
data_total_billed and billed_units fields to Super SIM UsageRecords API response.Eid parameter to optional to enable Activation Code download method support (breaking change)Verify
push.include_date parameter in create and update service.PR #601: Fixing logging of http request and response. Thanks to @rakatyal!
PR #600: add jinja2 for make docs. Thanks to @JenniferMah!
Library - Chore
Library - Fix
Api
provider_sid visibility to privateVerify
AccessTokens factor_friendly_name property.Voice
Remove Commands resource, use SmsCommands resource instead (breaking change)
Api
stream url parameter to non optionalverify-totp and verify-whatsapp-conversations-business-initiated categories to usage_record APIChat
Flex
channel_configs object to Flex ConfigurationMedia
Supersim
Taskrouter
split_by_wait_time for Cumulative Statistics EndpointVideo
status_callback_method type from enum to http_method (breaking change)status_callback and status_callback_method to compositionstatus_callback and status_callback_method to recordingPR #591: push Datadog Release Metric upon deploy success. Thanks to @eshanholtz!
Library - Chore
Api
Chat
X-Twilio-Wehook-Enabled header to delete method in UserChannel resourceNumbers
failure_reason in the Supporting Documents resourcesVerify
metadata parameter to "verify challenge" endpoint, so the SDK/App can attach relevant information from the device when responding to challenges.ttl and date_created properties to AccessTokens.Detected a bug and removed optional boolean include_soft_deleted parameter to retrieve soft deleted recordings. (breaking change)
Api
uri to stream resourcea2p-registration-fee) to usage recordsNumbers
Preview
web_channels from preview to beta under flex-api (breaking change)Taskrouter
ETag as Response Header to List of Task, Reservation & WorkerVerify
metadata to factors.Twiml
Fixed DELETE request to accept "sid_like" params in Address Configuration resources (breaking change)
Library - Chore
Library - Test
Api
stream resourceConversations
sms and whatsappFax
Insights
call_state to call_status and remove whisper in conference participant summary (breaking change)Numbers
Supersim
ip_commands_url and ip_commands_method on Fleets resource for helper librariessim property in requests to create an SMS Command made to the /SmsCommands to accept SIM UniqueNames in addition to SIDsVerify
Added new endpoint to fetch Conference Participant Summary
Insights
Messaging
Verify
Make fixed time scheduling parameters public (breaking change)
Library - Chore
Library - Feature
Api
Messaging
Numbers
Video
Add optional boolean send_as_mms parameter to the create action of Message resource (breaking change)
Library - Feature
Api
call deleteConversations
Service Webhook Configuration resource fieldsInsights
Media
Video
EmptyRoomTimeout and UnusedRoomTimeout properties to a room; add corresponding parameters to room creationVoice
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>.Your coding agent can read these notes before it upgrades. Set up the MCP server →