NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #4242 most downloaded on npm
A Twilio helper library
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
11 versions withdrawn
withdrawn after publishing
16 years old
349 releases · first in 2011
Nothing published for this version
PR #991: sync with main. Thanks to @tiwarishubham635!
One column per quarter.
Remove live_activity package from the lookup response (breaking change)
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 verbUpdated service base url for connect apps and authorized connect apps APIs (breaking change)
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)
Library - Fix
Library - Chore
Oauth
PR #985: Removing tests for Autopilot and Understand Endpoints - product EoL. Thanks to @miriamela!
Library - Chore
Push
Updated service base url for connect apps and authorized connect apps APIs (breaking change)
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.Deleted redacted parameter from fetching transcript in v2 (breaking change)
Library - Chore
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 #961: update security method validatessl. Thanks to @AsabuHere!
Library - Fix
Lookups
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)
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
Change Bulk_hosted_sid from BHR to BH prefix in HNO and dependent under version /v2 API's. (breaking change)
Library - Fix
Insights
Numbers
/v2 API's. (breaking change)Verify
Added voice-intelligence, voice-intelligence-transcription and voice-intelligence-operators to usage_record API.
Api
voice-intelligence, voice-intelligence-transcription and voice-intelligence-operators to usage_record API.tts-google to usage_record API.Lookups
disposable_phone_number_risk package to the lookup responseVerify
date_created_after and date_created_before expected date format.date_created_after and date_created_before expected date format parameter on attempts summary API.WHATSAPP as optional valid parameter on attempts summary API.Twiml
statusCallback and statusCallbackMethod attributes to <Siprec>.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)
Library - Fix
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)
Library - Docs
Conversations
start_date, end_date and state query parameters from list operation on Conversations resource (breaking change)Messaging
messaging_service_sids and messaging_service_sid_action from domain config endpoint (breaking change)Numbers
/v1.Twiml
Say verbRemove disposable_phone_number_risk package (breaking change)
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 - Fix
Library - Docs
Api
friendly_name in Available Phone Number Local, Mobile and TollFree resourcesfriendly_name in Available Phone Number Local, Mobile and TollFree resources (breaking change)Lookups
validation_results from the default_output_propertiesMessaging
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 librariesPR #917: export enum types. Thanks to @childish-sambino!
Library - Feature
Library - Test
Library - Fix
Api
scheduled_for property from message resourcescheduled_for property to message resourcePR #911: restore test-docker rule. Thanks to @beebzz!
PR #910: use relative root for library type imports. Thanks to @childish-sambino!
Library - Fix
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
Library - Test
Library - Fix
Library - Chore
Library - Docs
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> verbNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Release Notes ------------ Library - Chore - Test Release must not be used [Docs]
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
Library - Chore
Library - Feature
Conversations
Lookups
no_data to data_not_available in identity match packageMessaging
PR #849: touch up request validator. Thanks to @beebzz!
Library - Chore
Library - Fix
Make method optional for user defined message subscription (breaking change)
Library - Fix
Library - Feature
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)PR #831: add prepublish step for compiling. Thanks to @childish-sambino!
Library - Fix
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
Library - Miscellaneous
Library - Chore
Library - Test
Library - Feature
Api
contentSid and contentVariables to Message resource with public visibility as BetaUserDefinedMessageSubscription and UserDefinedMessage resourcevirtual-agent to usage_record API.beta feature from scheduling params and remove optimize parameters. (breaking change)amazon-polly to usage_record API.Conversations
identity as part of Participant's resource (breaking change)Flex
assessments api in version v1base_url to 'gooddata' response in version v1v1close status from Flex Interactions flow (breaking change)debugger_integration and flex_ui_status_report to Flex Configurationstatus, error_code, and error_message fields to Interaction Channelmessenger and gbm as supported channels for Interactions APIInsights
answered_by field in List Call Summaryanswered_by field in call summaryannotation field in call summaryLookups
identity_match package to the lookup responseenhanced_line_type from the lookup response (breaking change)Messaging
validated parameter to Link Shortening APIOauth
Proxy
Routes
Serverless
Studio
Supersim
DataLimit on a Fleetsim_ip_addresses resource to helper librariesTaskrouter
Ordering query parameter to Workers and TaskQueues for sorting byworker_sid query param for list reservations endpointVerify
ga maturitycode stays as the first parameter (breaking change)service_sid to verify_service_sid to be consistent with list attempts API (breaking change)code optional on Verification check to support sna attempts.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)Video
Anonymize APITwiml
Gather.url and method attributes to <Conversation>requireMatchingInputs attribute and input-matching-failed errorType to <Prompt>Number and Sipevent value call-in-progress to call-answered<lang>.maxQueueSize to EnqueuestatusCallbackMethod attribute, nested <Config and <Parameter> elements to <VirtualAgent> noun.Say verb<Conversation> nounPR #848: bypass audit failures until v4 release. Thanks to @childish-sambino!
Library - Test
Conversations
Lookups
no_data to data_not_available in identity match packageMessaging
Make method optional for user defined message subscription (breaking change)
Library - Docs
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 #823: 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 #782: 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
Library - Feature
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)
Library - Docs
Library - Feature
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 - 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)
Library - Docs
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 #755: use Docker 'rc' tag for release candidate images. Thanks to @childish-sambino!
Library - Chore
Add property media_url to the recording resources
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.Updated provider_sid visibility to private
Api
provider_sid visibility to privateVerify
AccessTokens factor_friendly_name property.Voice
Remove Commands resource, use SmsCommands resource instead (breaking change)
Library - Chore
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 recordingYour coding agent can read these notes before it upgrades. Set up the MCP server →