Announcing GA Release: Auth0 JavaSDK v3.0.0

[tanya732]

Overview

We’re excited to share that V3 of the Auth0 Java SDK is now GA! This major release represents a significant evolution of the Java client library for Auth0, designed to make integrating with Auth0’s Authentication and Management APIs simpler, clearer.

---

🚀 What’s New in v3

Added Features

• OpenAPI-generated SDK based on Auth0 specifications
• Stronger type safety using enums
• Automatic pagination support (SyncPagingIterable)
• Nullability annotations on all generated models
• Centralized error handling via ManagementApiException
• Explicit null support for PATCH requests
• Upgraded to OkHttp 5.2.1

---

🧩 Migration Example

Client Initialization
The Management API client initialization has changed from ManagementAPI to ManagementApi, and uses a different builder pattern.

Before (V2):

import com.auth0.client.mgmt.ManagementAPI;

// Using domain and token
ManagementAPI mgmt = ManagementAPI.newBuilder("{YOUR_DOMAIN}", "{YOUR_API_TOKEN}").build();

// Using TokenProvider
TokenProvider tokenProvider = SimpleTokenProvider.create("{YOUR_API_TOKEN}");
ManagementAPI mgmt = ManagementAPI.newBuilder("{YOUR_DOMAIN}", tokenProvider).build();

After (V3): Approach : Standard Token-Based

import com.auth0.client.mgmt.ManagementApi;

ManagementApi client = ManagementApi
    .builder()
    .url("https://{YOUR_DOMAIN}/api/v2")
    .token("{YOUR_API_TOKEN}")
    .build();

---

📦 Installation

Add the dependency via Maven:

<dependency>
  <groupId>com.auth0</groupId>
  <artifactId>auth0</artifactId>
  <version>3.0.0</version>
</dependency>

or Gradle:

implementation 'com.auth0:auth0:3.0.0'

---

📌 Important Notes:

• The Authentication API remains functionally compatible, with deprecated APIs removed
• Complete migration guide available at MIGRATION_GUIDE.md
• This is the stable GA release following V3.0.0-beta.0

---

💬 Feedback

We’d love to hear your feedback! Join the discussion or open an issue on GitHub