Android Custom Login

This quickstart will show you how to add Auth0 login capabilities while using a customized login screen.

Sample Project

Download this sample project configured with your Auth0 API Keys.

System Requirements
  • Android Studio 2.2
  • Android SDK 24
  • Emulator - Nexus 5X - Android 6.0
Show requirements

Before Starting

Go to the Client Settings section in the Auth0 dashboard and make sure that Allowed Callback URLs contains the value:


Add The Auth0 Android Dependency

Your first step is to add Auth0 Android into your project, which is basically the library that will manage the login process, via Auth0 Authentication Client.

i. Gradle

Add to your app's module Gradle file:

compile ''

Then, run "Sync project with Gradle files" inside Android Studio or ./gradlew clean assembleDebug from the command line.

For more information about Gradle usage, check their official documentation.

2. Configure Your Manifest File

You need to add the following permissions inside the AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />

Implement The Login

At this point, you're all set to implement the login in any activity you want.

Using a Database connection

First, you'll need to instantiate the Authentication API:

private void login(String email, String password) {
    Auth0 auth0 = new Auth0("YOUR_CLIENT_ID", "YOUR_AUTH0_DOMAIN");
    AuthenticationAPIClient client = new AuthenticationAPIClient(auth0);

    // proper login

Then, login using the username and password.

String connectionName = "Username-Password-Authentication";
client.login(email, password, connectionName)
    .start(new BaseCallback<Credentials, AuthenticationException>() {
        public void onSuccess(Credentials payload) {
            // Store credentials
            // Navigate to your main activity

        public void onFailure(AuthenticationException error) {
            // Show error to user

In this example we're logging in using an Auth0 Database Connection called "Username-Password-Authentication". You can also create your own.

There are multiple ways of designing a customized login screen which are not covered in this tutorial. You can take the Android Studio's login template as an example.

Using a Social connection

This requires an extra configuration step, as we need to capture the result that comes back from the browser once the user authenticates correctly.

First, edit the AndroidManifest.xml file and include an Intent-Filter. This will capture any fired intent matching the callback url we've defined at the beginning of the article, and redirect the result to our activity. Without this, even if the authentication in the browser succeed, we won't receive any data.

<application android:theme="@style/AppTheme">

        <!-- ... -->


            <intent-filter android:autoVerify="true">
                <action android:name="android.intent.action.VIEW" />

                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />

                    android:scheme="https" />


        <!-- ... -->


It's super important to specify the android:launchMode="singleTask" in your activity to ensure the authentication state it's not lost along redirects and that the result arrives back in the same activity instance that first requested it.

Second, override the onNewIntent method in your activity. Here is where the result arrives. Redirect the received intent to the WebAuthProvider#resume method.

public class MyActivity extends Activity {

    protected void onNewIntent(Intent intent) {
        if (WebAuthProvider.resume(intent)) {

Now perform the login by calling WebAuthProvider#init. If no connection name is given, the hosted Lock widget will be shown and the user may choose any of the connections enabled for your client. You can change this by calling withConnection. Let's do that for Twitter. Make sure to use a connection enabled in your client!

private void login() {
    Auth0 auth0 = new Auth0("YOUR_CLIENT_ID", "YOUR_AUTH0_DOMAIN");
                  .start(MainActivity.this, new AuthCallback() {
                      public void onFailure(@NonNull Dialog dialog) {
                        // Show error Dialog to user

                      public void onFailure(AuthenticationException exception) {
                        // Show error to user

                      public void onSuccess(@NonNull Credentials credentials) {
                          // Store credentials
                          // Navigate to your main activity

There are many options to customize the authentication using WebAuthProvider. Make sure to check them here.

Previous Tutorial
2. Login
Use Auth0 for FREECreate free Account