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
PR #742: 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.One column per quarter.
Detected a bug and removed optional boolean include_soft_deleted parameter to retrieve soft deleted recordings. (breaking change)
Library - Chore
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 - Feature
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
PR #727: run audit only on non dev dependencies. Thanks to @shwetha-manvinkurke!
Library - Chore
Insights
Messaging
Verify
Make fixed time scheduling parameters public (breaking change)
Library - Chore
Library - Feature
Library - Fix
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>.PR #707: make ttl optional in ClientCapabilityOptions. Thanks to @ghmeier!
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>.PR #705: node setup wf step. Thanks to @shwetha-manvinkurke!
Corrected enum values for emergency_address_status values in /IncomingPhoneNumbers response. (breaking change)
Library - Feature
Library - Fix
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.PR #692: add API response headers to the returned response. Thanks to @childish-sambino!
Library - Feature
Events
Messaging
Add 'mock' as an optional field to brand_registration api
Api
siprec resourcesiprec resourceMessaging
Verify
PR #687: webhook validation with an array parameter. Thanks to @askel4dd!
Library - Fix
Library - Chore
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)
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.PR #680: update user agent string for better debugging. Thanks to @philnash!
Library - Chore
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)
Library - Chore
Api
status enum for Messages to include 'canceled'update_status enum for Messages to include 'canceled'Trusthub
PR #675: remove @type/express. Thanks to @JenniferMah!
Library - Fix
Events
Verify
challenge adding the maximum and minimum expected lengths of some fields.notification by updating the documentation of the field ttl.PR #673: resolves jsdoc / underscore security vulnerability. Thanks to @thinkingserious!
Library - Chore
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)
Library - Chore
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)
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 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)
Library - Chore
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 - Fix
Library - Chore
Events
Messaging
Studio
Verify
api.verify.totp beta feature.Twiml
<VirtualAgent> nounRemove A2P campaign and use cases API (breaking change)
Events
Messaging
Trusthub
Verify
Remove If-Match header for Document (breaking change)
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)
Api
Conversations
last_read_message_index type in Participant's resource (breaking change)Insights
created_time to call summary.Sync
Video
PR #640: axios update to v0.21.1. Thanks to @ShelbyZ!
Library - Fix
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)
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)
Library - Chore
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 - Fix
Library - Feature
Library - Chore
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)
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)Add optional property call_reason in the participant create request
Api
call_reason in the participant create requestMessaging
Serverless
Video
Change resource path for Webhook Configuration
Accounts
Conversations
Events
PR #614: Prevent throwing an exception on 3xx response status code. Thanks to @Saka7!
Library - Fix
Conversations
Messaging
Numbers
Proxy
Supersim
AccountSid parameter to Sim resource update requestready status as an available status for a Sim resourcePR #605: allow lower versions of typescript (2.5). Thanks to @thinkingserious!
Library - Fix
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 - Docs
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
PR #592: upgrade dependencies and ignore low severity vulnerabilities. Thanks to @childish-sambino!
Library - Fix
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)
Library - Fix
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.Require a Network Access Profile when creating a Fleet (breaking change)
Library - Docs
Api
pstnconnectivity to usage_record APINotify
Preview
BrandsInformation endpoint now returns a single BrandsInformationSupersim
Removed insights preview API from API Definitions (breaking change)
Autopilot
Contacts
Numbers
provisionally-approved as a Bundle statusPreview
kyc-apipreview API from API Definitions (breaking change)BrandsInformation endpoint to query brands information stored in KYCRenamed 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 #571: regional/edge precendence and env vars. Thanks to @eshanholtz!
Library - Fix
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 #568: logic refactor. Thanks to @thinkingserious!
Library - Chore
Library - Feature
Preview
Dispatch version to previewStudio
Supersim
PR #560: type declaration for IncomingPhoneNumberInstance. Thanks to @thinkingserious!
Library - Fix
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 detailsTwiml
speech_model for the Gather verbPR #558: add list instance types and update 'object' type properties to 'any' in TS. Thanks to @childish-sambino!
Library - Fix
Library - Chore
Studio
warnings attribute v2 flow POST apiRemove deactivated status for Super SIM which is replaced by inactive (breaking change)
Library - Fix
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)PR #547: add status validator to request options so non-2XXs can be wrapped in a 'RestException'. Thanks to @childish-sambino!
Library - Fix
Added config param to Factor creation (breaking change)
Library - Fix
Library - Feature
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 - Docs
Library - Fix
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>Your coding agent can read these notes before it upgrades. Set up the MCP server →