---
schema_version: "1"
id: 360090f7654f848268e85e38dc0110aa164675951ba3cc5cec9fc5dc72a1295b
title: Configure Android Push Notifications
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/connected_app_mobile_push_notifications_android.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.connected_app_mobile_push_notifications_android.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 7f31976555f42316bfc2621c2b34a4cb5a842e8abd64898fe6371cd5e7b1f16c
description: 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.
products:
  - Security
  - Cross Cloud
release: "264"
---
# 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

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
        <colgroup>
          <col>
        </colgroup>
        <tbody>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Available in: both Salesforce Classic and Lightning Experience</td>
          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <p>Connected Apps can be created in: <strong>Group</strong>, <strong>Essentials</strong>,
                <strong>Professional</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and
                <strong>Developer</strong> Editions
              </p>
              <p style="margin-bottom:0;">Connected Apps can be installed in: All
                editions</p>
            </td>
          </tr>
        </tbody>
      </table> <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d40100e62">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">To read, create, update, or delete connected apps:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">
              <p>Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All Data OR Manage Connected
                Apps</p>
            </td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">To update all fields except Profiles, Permission Sets, and Service Provider
              SAML Attributes:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">
              <p>Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All Data OR Manage Connected
                Apps</p>
            </td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">To update Profiles, Permission Sets, and Service Provider SAML
              Attributes:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">Customize Application AND Modify All Data AND Manage Profiles and Permission
              Sets</td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">To rotate the consumer key and consumer secret:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">Allow consumer key and secret rotation</td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">To install and uninstall connected apps:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">
              <p>Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All Data OR Manage Connected
                Apps</p>
            </td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">To install and uninstall packaged connected apps:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d40100e62 ">
              <p>Download AppExchange Packages AND Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All
                Data OR Manage Connected Apps</p>
            </td>
          </tr>
        </tbody>
      </table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-identity-264-0-0-production-enus/699dab6f-8f1a-4662-b24f-6521d5b747f7/images/icon_note.png)

Note Connected apps creation is restricted as of Spring ‘26. You can continue to use existing connected apps during and after Spring ‘26. However, we recommend using [external client apps](https://help.salesforce.com/s/articleView?id=xcloud.external_client_apps.htm&language=en_US) instead. If you must continue creating connected apps, contact Salesforce Support.

See [New connected apps can no longer be created in Spring ‘26](https://help.salesforce.com/s/articleView?id=005228017&type=1&language=en_US) for more details.

If you have an existing Firebase project associated with your app, log in to the [Google Cloud Console](https://console.developers.google.com/apis/dashboard?project=_) 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.

1. 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](https://console.firebase.google.com/).
    
    ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-identity-264-0-0-production-enus/699dab6f-8f1a-4662-b24f-6521d5b747f7/images/icon_important.png)
    
    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.
2. In the Firebase project, click the cog icon next to Project Overview, and then click **Project settings**.
3. Collect the Firebase project ID.
    1. Click the **General** tab.
    2. Record the value in the Project ID field. You need the project ID for a later step.
4. Generate an Admin SDK private key for your Firebase service account.
    1. Select the **Service accounts** tab, and then click **Generate new private key**.
    2. 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.
5. Create your [mobile connected app](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_create_mobile.htm&release=264.0.0&type=5 "A connected app is a primary means by which a mobile app connects to Salesforce. Although not required, you can use Salesforce Mobile SDK to build mobile applications as connected apps. These connected apps can access Salesforce OAuth services and call Salesforce REST APIs.") in App Manager.
6. In the Mobile App Settings section of your mobile connected app, complete these fields.
    1. In the **App Platform** field, select **Android**.
    2. Select **Push Messaging**.
    3. In the **Platform** field, select **Android**.
    4. 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.
    5. In the **Project ID** field, enter the project ID that you collected from the Firebase project.
7. Save your changes.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-identity-264-0-0-production-enus/699dab6f-8f1a-4662-b24f-6521d5b747f7/images/icon_note.png)

Note If you update the push messaging fields for an existing mobile connected app, and the app is distributed to other Salesforce orgs in a managed package, make sure to distribute the push messaging update to all orgs that use the app. To distribute the push messaging update, upload a new managed package version, and then install the new package in all orgs that use the app. See [Installed Packages](https://help.salesforce.com/s/articleView?id=xcloud.distribution_installed_packages.htm&type=5&language=en_US) for more information.