Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Configuring Android Push Notifications

In this guide, we'll go through all the necessary steps to get your Android push credentials configured with Twilio Notify. The end result is a properly configured Android app and a Twilio Notify Push Credential which you can then use to send notifications to your Android app. Let's get started!

Step 1 - Create a project on Firebase

step-1---create-a-project-on-firebase page anchor

Google has replaced Google Cloud Messaging (GCM) with Firebase Cloud Messaging (FCM). To use push notifications for your Android apps, you will need to create a project on the Firebase Console(link takes you to an external page):

Create A Firebase Project.

Step 2 - Create a Configuration File

step-2---create-a-configuration-file page anchor

The Firebase Cloud Messaging (FCM) library requires a file called google-services.json in your Android project's app directory to link your app with Firebase services. The Firebase console has an easy way to generate this file, but you could also use Android Studio's Firebase integration. We'll use the web based approach in this guide.

After you create a Firebase project, you can add Firebase to your Android app:

Get Started With Firebase.

Clicking the middle link will bring up this dialog:

Add Firebase To Your Android App.

After filling in your Android app's package name, clicking the Add App button will automatically download the generated google-services.json file.

You will need to put that file into the app folder of your Android project, or Gradle won't be able to build your application after you add the Firebase libraries.

The next screen in the Firebase dialog will also explain where to put the file you just downloaded.

Step 3 - Set up your project's dependencies

step-3---set-up-your-projects-dependencies page anchor


You can skip this step if using the Quickstart app.

We have already pre-configured the quickstart app so you can just skip ahead to creating a credential.

Android Studio uses Gradle(link takes you to an external page) to parse your credentials from the google-services.json file. Your app has 2 build.gradle files, a project-level one and an app-level one.

Add this line to your project-level build.gradle in the dependencies section:

compile ""

Step 4 - Edit the Application Manifest

step-4---edit-the-application-manifest page anchor


You can skip this step if using the Quickstart app.

We have already pre-configured the quickstart app so you can just skip ahead to creating a credential.

To fully integrate your application with Firebase Cloud Messaging, you'll need to create two application-specific Android Services, and then add them to your AndroidManifest.xml file. Check out the quickstart app for an example of each of these services.

The first service to add is a messaging service that responds to Firebase messaging events. This service must extend from the Firebase Cloud Messaging library.

<action android:name="" />

Step 5 - Upload your API Key to Twilio

step-5---upload-your-api-key-to-twilio page anchor

With our app configured to receive push notifications, we'll need to create a matching FCM Credential that our Notify Service can use. In Firebase the secret is called a Server Key, and you can find it in your Firebase console under your Project Settings and Cloud Messaging tab.

Notify Configuring Android Notifications - Firebase Server Key.

Having that, you'll need to create a credential on the Add a Push Credential page on the Twilio Console:

Add Push Credentials.

From the drop-down, choose FCM and paste in your server key as the FCM Secret.

Step 6 - Create a Notify Service

step-6---create-a-notify-service page anchor

Twilio allows you to build multiple applications in a single account. To separate those applications you need to create Service instances that hold all the data and configuration for your application. On the Notify Services page of the Twilio Console, click the blue plus button to create a new Notify Service:

Create New Notify Service.

After naming your Notify Service (for instance, with the same name as your app), you can configure the service to use one or more messaging credentials, such as the FCM Credential we created in Step 5:

Configure your Notify Service.

You're now configured for Firebase Cloud Messaging, ready to write some code and send some push notifications with Twilio. Visit the Android Quickstart guide for the next step!

Rate this page: