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
| 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 |
See New connected apps can no longer be created in Spring ‘26 for more details.
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.
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 for explanations of messages. For additional information, see:
- developer.apple.com for information on Apple APNS push notifications.
- firebase.google.com 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
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
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
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.
