twilio-java SDK

In version 12.0.0, the deprecated io.jsonwebtoken.SignatureAlgorithm enum is replaced by the io.jsonwebtoken.security.SecureDigestAlgorithm API from jjwt 0.12.x.

Impacted Users: Users who pass an explicit algorithm parameter to ValidationClient, ValidationInterceptor, ValidationToken.fromHttpRequest(), ValidationToken.Builder.algorithm(), or who subclass com.twilio.jwt.Jwt directly.

Not Impacted: Users using default constructors for ValidationClient or ValidationInterceptor, or those only using AccessToken, ClientCapability, TaskRouterCapability, or REST API resource classes (e.g., Message, Call).

// 11.x.x
import io.jsonwebtoken.SignatureAlgorithm;

new ValidationClient(accountSid, credSid, signingKeySid, privateKey, SignatureAlgorithm.PS256);

new ValidationToken.Builder(accountSid, credSid, signingKeySid, privateKey)
    .algorithm(SignatureAlgorithm.RS256)
    .build();

// 12.x.x
import io.jsonwebtoken.Jwts;

new ValidationClient(accountSid, credSid, signingKeySid, privateKey, Jwts.SIG.PS256);

new ValidationToken.Builder(accountSid, credSid, signingKeySid, privateKey)
    .algorithm(Jwts.SIG.RS256)
    .build();

By default, the Twilio Java helper library creates a default TwilioRestClient using the credentials provided in Twilio.init(ACCOUNT_SID, AUTH_TOKEN). However, you can provide your own TwilioRestClient instance to override the default behavior. This is useful for connecting through a proxy server, adding custom HTTP headers, or implementing a mocking layer for unit testing.

To use a custom client, instantiate your TwilioRestClient and pass it to Twilio.setRestClient(twilioRestClient). All subsequent Twilio REST API calls will use this custom client.

// 1. Initialize Twilio with credentials
Twilio.init(ACCOUNT_SID, AUTH_TOKEN);

// 2. Create your custom TwilioRestClient
TwilioRestClient twilioRestClient = myCustomClientCreator.getClient();

// 3. Inject the custom client into the Twilio library
Twilio.setRestClient(twilioRestClient);

// 4. Now, API calls will use your custom client
Message message = Message.creator(
    new PhoneNumber("+15558675310"),
    new PhoneNumber("+15017122661"),
    "Hey there!"
).create();

To use the Twilio Java library, you must first initialize the client with your ACCOUNT_SID and AUTH_TOKEN. This is typically done using Twilio.init(accountSid, authToken).

If you are accessing endpoints that do not require basic authentication, use the TwilioNoAuth client. For endpoints requiring bearer tokens (like the Organization domain), you must use a custom client initialized with the necessary values for access token generation. Alternatively, you can implement the Token interface to provide a custom token manager implementation to bypass manual initialization steps.

import com.twilio.Twilio;
import com.twilio.exception.AuthenticationException;

public class Example {

  private static final String ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
  private static final String AUTH_TOKEN = "your_auth_token";

  public static void main(String[] args) throws AuthenticationException {
    Twilio.init(ACCOUNT_SID, AUTH_TOKEN);
  }
}

Version 8.0.0 dropped support for Java 7 and removed several Guava dependencies in favor of built-in Java 8+ functionality.

Executor Service Migration: Replace com.google.common.util.concurrent.ListeningExecutorService with java.util.concurrent.ExecutorService.

Asynchronous Request Migration: All asynchronous createAsync, fetchAsync, etc., return types changed from Guava's ListenableFuture to java.util.concurrent.CompletableFuture.

// 7.x.x
import com.google.common.util.concurrent.ListeningExecutorService;
import com.google.common.util.concurrent.MoreExecutors;

ListeningExecutorService listeningExecutorService = MoreExecutors.listeningDecorator(Executors.newCachedThreadPool());
Twilio.setExecutorService(listeningExecutorService);

// Async return type
ListenableFuture<IncomingPhoneNumber> incomingPhoneNumber = IncomingPhoneNumber.creator(new PhoneNumber("+11234567890")).createAsync();

// 8.x.x
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executor;

ExecutorService executorService = Executors.newCachedThreadPool();
Twilio.setExecutorService(executorService);

// Async return type
CompletableFuture<IncomingPhoneNumber> incomingPhoneNumber = IncomingPhoneNumber.creator(new PhoneNumber("+11234567890")).createAsync();