---
schema_version: "1"
id: 0b0580b3529822c1a30c9476364108c4bc045869a8465d897206a025a564ccd5
title: Test 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_test_push.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.connected_app_test_push.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 8d39e70809d3b49e96b9510d5a3a39b9531faad6497adfe9a831026e40805485
description: To run a quick test of your push notification setup, use the Send Test Notification page. Troubleshoot round-trip push notifications in a synchronous mechanism without having to configure custom notification types, Apex calls, or REST calls. You can also gain insights into what’s going on behind the scenes in the asynchronous environment of real-world push notifications.
products:
  - Security
  - Cross Cloud
release: "264"
---
# Test Push Notifications

To run a quick test of your push notification setup, use the Send Test Notification page. Troubleshoot round-trip push notifications in a synchronous mechanism without having to configure custom notification types, Apex calls, or REST calls. You can also gain insights into what’s going on behind the scenes in the asynchronous environment of real-world push notifications.

### 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>

![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.

![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 This information isn’t applicable to testing push notifications for branded mobile apps through the Mobile Publisher program.

The Send Test Notification page uses information from your Apple Push Notification Service (APNS) or Firebase Cloud Messaging (FCM) for Android setup to configure a synchronous push mechanism. You select a device to receive the push notification by entering a connection token string. If you don’t know the token string, you can use the Search tool to select from the list of devices that are registered for your connected app. The Search tool automatically displays the five most recently registered devices. You can also enter a user’s name to search for devices that are registered to that user.

![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 Before attempting to send test push notifications, verify that the mobile settings in your connected app are properly configured. See [Create a Connected App](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_create.htm&release=264.0.0&type=5 "When you create a connected app, make sure that you understand how it’s going to be used so you can configure the appropriate settings. For example, if you’re creating a connected app to integrate an external application with your Salesforce API, configure the connected app with OAuth authorization settings. Or if you’re creating a connected app to act as a service provider in a SAML single sign-on (SSO) flow, configure SAML settings.").

Push notifications aren't available in the console in Professional Edition.

For Android FCM push notifications, you can select the Dry Run option to test your FCM setup. This option sends the notification to the FCM server but doesn’t forward it to a device.

Each push attempt returns a status message that indicates success or failure. See [Error Messages for Push Notifications](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_push_errors.htm&release=264.0.0&type=5 "If you get an error message while sending a push notification from the Send Test Notification page, check the following table for suggestions on how to fix the error.") for explanations of messages. For additional information, see:

- [developer.apple.com](https://developer.apple.com/index.html) for information on Apple APNS push notifications.
- [firebase.google.com](https://firebase.google.com/docs/cloud-messaging) for information on FCM for Android push notifications.

## Push Notification Limits

An org can send up to 20,000 iOS and 10,000 Android push notifications per hour (for example, 4:00 to 4:59 UTC).

Only _deliverable_ notifications count toward this limit. For example, a notification is sent to 1,000 employees in your company, but 100 employees haven’t installed the mobile app yet. Only the notifications sent to the 900 employees who have installed the mobile app count toward this limit.

Each test push notification that is generated through the Test Push Notification page is limited to a single recipient. Test push notifications count toward an org’s hourly push notification limit.

When an org's hourly push notification limit is met, any additional notifications are still created for in-app display and retrieval via REST API.

- **[Send Test Push Notifications to APNS](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_test_apns.htm&release=264.0.0&type=5)**  
    To run a quick test of your push notification setup for Apple Push Notification Service (APNS), use the Send Test Notification page.
- **[Send Test Push Notifications to FCM for Android](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_test_gcm.htm&release=264.0.0&type=5)**  
    To run a quick test of your push notification setup for Firebase Cloud Messaging (FCM) for Android, use the Test Push Notifications page.
- **[Error Messages for Push Notifications](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_push_errors.htm&release=264.0.0&type=5)**  
    If you get an error message while sending a push notification from the Send Test Notification page, check the following table for suggestions on how to fix the error.

#### See Also

- [Send Mobile Push Notifications](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_mobile_push_notifications.htm&release=264.0.0&type=5 "Mobile push notifications allow Lightning Platform mobile app developers to easily push notifications to their users’ mobile devices when business events occur in the customers’ orgs. To enable push notifications, you must use the mobile connected apps framework.")