Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Configuring push notifications for Android apps

Updated on March 3, 2022

Keep the users up-to-date with various events in your business process by enabling automatic push notifications in your mobile app for Android devices.

Before you begin: Prepare the framework for enabling push notifications in your app:
  1. Set up a Google account that you can use to access Firebase.
  2. Create a certificate set for your app. For more information, see Creating an Android certificate set.
You configure push notification support for Android apps by obtaining and adding the following Firebase Cloud Messaging (FCM) services parameters to your Android mobile certificate set:
FCM server key
The key that the Pega Platform server uses to authenticate with the FCM services.
Google Services JSON
A JSON configuration file for FCM-based projects.

    Obtain the FCM parameters:

  1. Go to, sign in to your Firebase account, and then access the Firebase console.
    For more information about managing projects in Firebase, go to the Firebase documentation website.
  2. Create a Firebase project for your app.
  3. On the console dashboard, launch the setup workflow, and then add Firebase to your Android app:
    1. Register your app in Firebase.
      Important: When you register your app in Firebase, ensure that the Android package name in Firebase matches the App ID package name of your certificate in Pega Platform.
    2. Download the google-services.json file, and then finish the setup workflow.
      Note: You can also download the JSON file at any time from the project settings in your Firebase console.
  4. In the Firebase console, go to the cloud messaging settings, and then copy the server key.
  5. Add the FCM parameters to the certificate set that you want to use in your Android app:

  6. In the navigation pane of App Studio, click SettingsMobile certificates.
  7. Click the Android certificate set that you want to use in your Android app.
  8. In the FCM Server Key field, enter the server key from the Firebase console.
  9. In the Google Services JSON section, click New, and then upload the google-services.json file from the Firebase console.
  10. Click OK, and then save the certificate set.
What to do next: Ensure that your app receives automatic and manual push notifications by adding the certificate set that you updated to the mobile channel for your app. For more information, see Building mobile apps.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us