twilio · sbansla · Sep 30, 2025 · Jul 2, 2025 · Jul 2, 2025 · Jul 3, 2025
diff --git a/.github/workflows/test-and-deploy.yml b/.github/workflows/test-and-deploy.yml
@@ -62,7 +62,7 @@ jobs:
         with:
           distribution: 'zulu'
           java-version: '17'
-          
+
       - name: SonarCloud Scan
         if: ${{ (github.event_name == 'pull_request' || github.ref_type == 'branch') && matrix.java == 11 && !github.event.pull_request.head.repo.fork }}
         env:

diff --git a/CHANGES.md b/CHANGES.md
@@ -1,6 +1,76 @@
 twilio-java changelog
 =====================
 
+[2025-09-30] Version 11.0.0
+------------------------------------
+
+**Library - Breaking Changes**
+- Refer [Upgrade.md](https://github.com/twilio/twilio-java/blob/main/UPGRADE.md) for detailed migration notes and list of Breaking Changes.
+
+**Accounts**
+- Update beta feature flag for consent and contact bulk upsert APIs
+
+**Api**
+- Add `date_created` property to media resource and date_created filtering parameters for read action
+- Updated the Recordings Resource `channels` property to clarify channels = # of channels in the recording resource and how to specify the # of channels in recording download
+- Remove usage category enum from usage record and usage triggers API **(breaking change)**
+- Add multiple missing usage categories to usage records and usage triggers api
+- Add `channels-whatsapp-template-marketing` and `channels-whatsapp-template-utility` to usage categories
+
+**Bulkexports**
+- Changed the type of 'details' field to be a list of objects instead of a single object
+
+**Conversations**
+- Fix `state` spelling for `initializing` enum value
+- Update `state` to include `intializing` for ServiceConversationWithParticipants and ConversationWithParticipants
+- Updates to `method` casing for ConfgurationAddress, ConversationScopedWebhook, and ServiceConversationScopedWebhook for RestProxy compatibility
+
+**Events**
+- Remove `SinkSid` parameter when updating subscriptions. **(breaking change)**
+
+**Intelligence**
+- Add encryption_credential_sid field in transcripts and services in v2
+
+**Flex**
+- Adding new optional parameter `identity` to `web_channels` API in version `v2`
+- update team name for web_channel, webchat_init_token, webchat_refresh_token
+
+**Verify**
+- Add passkeys support to Verify API creating and updating services.
+- Update `ienum` type for Factor creation
+- Add passkeys as challenge and factor type
+
+**Proxy**
+- remove shortcodes resource as its no longer used
+
+**Studio**
+- Add `type` to Step resource APIs
+
+**Serverless**
+- Change log field level from type `ienum` to `string` in Logs api
+
+**Taskrouter**
+- Remove `URL-encoded` from attributes param definition in tasks
+
+**Trunking**
+- Added `symmetric_rtp_enabled` property on Trunks.-
+
+**Trusthub**
+- Remove beta feature flag for all TH APIs
+- Remove beta feature flag for ComplianceInquiries API to support OneConsole traffic
+- Add required Permissions to the ComplianceInquiries API
+
+**Twiml**
+- Add new noun `<AiSession>`
+- Remove Duplicates.
+- Add Polly Generative voices.
+- Add Latest Google (Chirp3-HD) voices.
+- Add support for `<WhatsApp>` noun under `<Dial>` verb
+
+**Verify**
+- Allow to update all passkeys parameters in the service update
+
+
 [2025-06-12] Version 10.9.2
 ---------------------------
 **Library - Chore**

diff --git a/README.md b/README.md
@@ -62,15 +62,15 @@ Use the following dependency in your project to grab via Maven:
 <dependency>
   <groupId>com.twilio.sdk</groupId>
   <artifactId>twilio</artifactId>
-  <version>10.X.X</version>
+  <version>11.X.X</version>
   <scope>compile</scope>
 </dependency>
 ```
 
 or Gradle:
 
 ```groovy
-implementation "com.twilio.sdk:twilio:10.X.X"
+implementation "com.twilio.sdk:twilio:11.X.X"
 ```
 
 If you want to compile it yourself, here's how:
@@ -221,8 +221,8 @@ public class Example {
 We are introducing Client Credentials Flow-based OAuth 2.0 authentication. 
 This feature is currently in `beta` and its implementation is subject to change.
 
-- API examples [here](https://github.com/twilio/twilio-java/blob/main/examples/FetchMessageUsingOAuth.md)
-- Organisation API examples [here](https://github.com/twilio/twilio-java/blob/main/examples/BearerTokenAuthentication.md)
+- API examples [here](https://github.com/twilio/twilio-java/blob/main/examples/PublicOAuthExample.md)
+- Organisation API examples [here](https://github.com/twilio/twilio-java/blob/main/examples/OrgsAPIExample.md)
 
 ### Iterate through records
 
@@ -366,3 +366,5 @@ If you've instead found a bug in the library or would like new features added, g
 [apidocs]: https://www.twilio.com/docs/api
 [twiml]: https://www.twilio.com/docs/api/twiml
 [libdocs]: https://twilio.github.io/twilio-java
+
+
diff --git a/UPGRADE.md b/UPGRADE.md
@@ -2,7 +2,33 @@
 
 _`MAJOR` version bumps will have upgrade notes posted here._
 
+[2025-09-30] 10.x.x to 11.x.x
+-----------------------------
+### Overview
+##### Twilio Java Helper Library’s major version 11.0.0 is now available. 11.0.0 version contains breaking changes
+
+##### Breaking Changes
+###### 1. NetworkHttpClient upgraded from HttpClient4 → HttpClient5
+Who are impacted: 
+Users who override NetworkHttpClient.
+
+###### 2. Bug Fix: Enum suffix removed (StatusEnum → Status)
+This was a bug in Account resource in Organisation API
+
+###### 3. Organisation API — Organisation API init authentication mechanism has been changed.
+Who are impacted:
+Users calling the Organisation API. Refer Examples
+Organisation API examples [here](https://github.com/twilio/twilio-java/blob/main/examples/OrgsAPIExample.md)
+
+###### 4. Bug Fix: Using Object data type for [anyType](https://swagger.io/docs/specification/v3_0/data-models/data-types/#any-type) fields in open-api specifications
+Who are impacted:
+Properties/Parameters defined as [anyType](https://swagger.io/docs/specification/v3_0/data-models/data-types/#any-type) in open-api specifications will be represented using `Object` now.
+Previous data type: `Map<String,Object>`
+New data type: `Object`
+
+
 [2024-02-08] 9.x.x to 10.x.x
+-----------------------------
 ### Overview
 
 ##### Twilio Java Helper Library’s major version 10.0.0 is now available. We ensured that you can upgrade to Java helper Library 10.0.0 version without any breaking changes of existing apis

diff --git a/advanced-examples/custom-http-client.md b/advanced-examples/custom-http-client.md
@@ -81,10 +81,10 @@ Now that we understand how all the components fit together, we can create our ow
 import com.twilio.http.HttpClient;
 import com.twilio.http.NetworkHttpClient;
 import com.twilio.http.TwilioRestClient;
-import org.apache.http.HttpHost;
-import org.apache.http.client.config.RequestConfig;
-import org.apache.http.impl.client.HttpClientBuilder;
-import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;
+import org.apache.hc.client5.http.config.RequestConfig;
+import org.apache.hc.client5.http.impl.classic.HttpClientBuilder;
+import org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager;
+import org.apache.hc.core5.http.HttpHost;
 
 public class ProxiedTwilioClientCreator {
 
@@ -120,8 +120,7 @@ public class ProxiedTwilioClientCreator {
   private void createHttpClient() {
     RequestConfig config = RequestConfig
       .custom()
-      .setConnectTimeout(10000)
-      .setSocketTimeout(30500)
+      .setConnectTimeout(Timeout.ofMilliseconds(10000))
       .build();
 
     PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager();

diff --git a/examples/BearerTokenAuthentication.md b/examples/BearerTokenAuthentication.md
diff --git a/examples/FetchMessageUsingOAuth.md b/examples/FetchMessageUsingOAuth.md
diff --git a/examples/OrgsAPIExample.md b/examples/OrgsAPIExample.md
@@ -0,0 +1,34 @@
+    class OrgsAPIExample {
+        public static void main {
+
+            private static final String GRANT_TYPE = "grant_type_to_be_used";
+            private static final String CLIENT_SID =
+            "client_id_of_the_organization";
+            private static final String CLIENT_SECRET = "client_secret_of_organization";
+            private static final String ORGANISATION_ID = "id_of_the_organization";
+
+            //Getting access token - Method #1
+            Twilio.init(new OrgsClientCredentialProvider(CLIENT_SID, CLIENT_SECRET));
+            fetchAccountDetails();
+
+
+            //Scenario: 2 If in case one doesn't want to change the existing stored credential
+            // Pass Custom TwilioRestClient
+            // TokenManager tokenManager = new OrgsTokenManager(GRANT_TYPE, CLIENT_SID, CLIENT_SECRET);
+            // TokenAuthStrategy tokenAuthStrategy = new TokenAuthStrategy(tokenManager);
+            // TwilioRestClient client = new TwilioRestClient.Builder(tokenAuthStrategy).build();
+            // fetchAccountDetailsWithClient(client);
+        }
+
+        private static void fetchAccountDetails() {
+           ResourceSet<Account> accountSet = Account.reader(ORGANISATION_ID).read();
+           String accountSid = accountSet.iterator().next().getAccountSid();
+           System.out.println(accountSid);
+        }
+
+        private static void fetchAccountDetailsWithClient(TwilioRestClient client) {
+           ResourceSet<Account> accountSet = Account.reader(ORGANISATION_ID).read(client);
+           String accountSid = accountSet.iterator().next().getAccountSid();
+           System.out.println(accountSid);
+        }
+    }
diff --git a/examples/PublicOAuthExample.md b/examples/PublicOAuthExample.md
@@ -0,0 +1,35 @@
+```
+class PublicOAuthExample {
+    public static void main {
+
+        private static final String GRANT_TYPE = "grant_type_to_be_used";
+        private static final String OAUTH_CLIENT_SID = "client_id";
+        private static final String OAUTH_CLIENT_SECRET = "client_secret";
+        private static final String ACCOUNT_SID = "account_sid";
+        private static final String MESSAGE_SID = "message_sid";
+
+        //Getting access token - Method #1
+        Twilio.init(new ClientCredentialProvider(OAUTH_CLIENT_SID, OAUTH_CLIENT_SECRET), ACCOUNT_SID);
+        fetchMessage(MESSAGE_SID);
+
+
+        //Scenario: 2 If in case one doesn't want to change the existing stored credential
+        // Pass Custom TwilioRestClient
+        // TokenManager tokenManager = new ApiTokenManager(GRANT_TYPE, OAUTH_CLIENT_SID, OAUTH_CLIENT_SECRET);
+        // TokenAuthStrategy tokenAuthStrategy = new TokenAuthStrategy(tokenManager);
+        // TwilioRestClient client = new TwilioRestClient.Builder(tokenAuthStrategy).accountSid(ACCOUNT_SID).build();
+        // fetchMessageWithClient(MESSAGE_SID, client);
+    }
+
+    public static void fetchMessage(String sid) {
+        Message message = Message.fetcher(sid).fetch();
+        System.out.println("Fetched Message SID: " + message.getSid());
+    }
+
+    public static void fetchMessageWithClient(String sid, TwilioRestClient client) {
+        Message message = Message.fetcher(sid).fetch(client);
+        System.out.println("Fetched Message SID: " + message.getSid());
+    }
+}
+```
+