Configure Android Push Notifications
To support push notifications for Android versions of your mobile app, collect information from a Google Firebase project. Then, create a separate connected app for the Android platform.
Required Editions
| Available in: both Salesforce Classic and Lightning Experience |
Connected Apps can be created in: Group, Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions Connected Apps can be installed in: All editions |
| User Permissions Needed | |
|---|---|
| To read, create, update, or delete connected apps: | Customize Application AND either Modify All Data OR Manage Connected Apps |
| To update all fields except Profiles, Permission Sets, and Service Provider SAML Attributes: | Customize Application AND either Modify All Data OR Manage Connected Apps |
| To update Profiles, Permission Sets, and Service Provider SAML Attributes: | Customize Application AND Modify All Data AND Manage Profiles and Permission Sets |
| To rotate the consumer key and consumer secret: | Allow consumer key and secret rotation |
| To install and uninstall connected apps: | Customize Application AND either Modify All Data OR Manage Connected Apps |
| To install and uninstall packaged connected apps: | Download AppExchange Packages AND Customize Application AND either Modify All Data OR Manage Connected Apps |
See New connected apps can no longer be created in Spring ‘26 for more details.
If you have an existing Firebase project associated with your app, log in to the Google Cloud Console and select the project for your app. In the Enabled APIs & services page, confirm that the Firebase Cloud Messaging API is enabled for the project.
- If you have an existing Firebase project associated with your app, open the existing
project. If not, create a project for your app in the Google Firebase Console.
Important If you previously set up notifications for your Android app, make sure that you proceed with the next steps using the existing Firebase project associated with your app. To avoid any disruption in your app’s notifications, confirm that the sender ID in the Firebase project matches your app’s existing sender ID. - In the Firebase project, click the cog icon next to Project Overview, and then click Project settings.
- Collect the Firebase project ID.
- Click the General tab.
- Record the value in the Project ID field. You need the project ID for a later step.
- Generate an Admin SDK private key for your Firebase service account.
- Select the Service accounts tab, and then click Generate new private key.
- Download the JSON file that contains the private key. Note the location of the
downloaded file, because you need it later.The file name format for this private key is similar to Pc-api-1234567890123456789-123-firebase-adminsdk-a1bcd-a1234bc5678.json.
- Create your mobile connected app in App Manager.
- In the Mobile App Settings section of your mobile connected app, complete these
fields.
- In the App Platform field, select Android.
- Select Push Messaging.
- In the Platform field, select Android.
- In the Firebase Admin SDK Private Key field, upload the JSON file that contains the private key that you generated for your Firebase service account.
- In the Project ID field, enter the project ID that you collected from the Firebase project.
- Save your changes.

