Loading
Salesforce now sends email only from verified domains. Read More
Identify Your Users and Manage Access
Table of Contents
Filter by (0)Add
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

            Search all of Salesforce Help
            Search all of Salesforce Help
            Error Messages for Push Notifications

            You are here:

            1. Salesforce Help
            2. Docs
            3. Identify Your Users and Manage Access

            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.

            Note
            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 instead. If you must continue creating connected apps, contact Salesforce Support.

            See New connected apps can no longer be created in Spring ‘26 for more details.

            Message Suggested Resolution
            Certificate is not accepted by Apple Push Notification service Replace the certificate with a valid type.
            Certificate is revoked Supply a valid certificate.
            Certificate expired Renew a certificate.
            Certificate not valid yet Retry later.
            Invalid certificate or password Replace the certificate with a valid type.
            Invalid recipient or payload Check your input for errors.
            Payload exceeds maximum size Reduce the size of the payload.
            Unable to load push notifications settings Confirm that the settings are present on the external client app.
            Recipient field contains invalid device token Provide a valid device token.
            Invalid device token length Token was entered incorrectly or is corrupt. Re-enter the token.
            Error while sending notification. Confirm certificate is for the correct Apple environment. Confirm that the correct certificate is being used (for example, sandbox versus production).
            Apple Push Notification service is unavailable. Retry later.
            Unable to connect to Apple Push Notification service Retry later.
            Unable to connect to Salesforce proxy. Contact Salesforce support if issue persists. Retry later.
            Request blocked by Salesforce proxy. Contact Salesforce support if issue persists. Retry later.
            Apple Push Notification service returned unknown error Contact Apple or retry later.
            Badge must be a number Re-enter the badge value as an integer.
            Payload must be in a valid JSON format Format the payload correctly.
            You must enter a value for at least one of the following fields: Alert, Badge, Sound, or Custom Payload Enter a valid value for one of the fields.
            Recipient is required Provide a device token.
            Firebase Cloud Messaging authentication error

            Consult the FCM documentation at developer.android.com. Possible causes:

            • Authorization header is missing or contains invalid syntax.

            • Invalid project number was sent as key.

            • Key is valid, but FCM service is disabled.

            • Request originated from a server that is not white-listed in the server key IP addresses.
            Internal error in the Firebase Cloud Messaging server, or the server is temporarily unavailable Retry later.
            Registration ID in the Recipient field is formatted incorrectly Verify that the mobile app is providing valid registration ID, or manually enter valid registration ID.
            Payload exceeds maximum size Reduce the size of the payload.
               
            Recipient is required Select a recipient or provide registration ID.
            Recipient field contains invalid registration ID Update the recipient’s device registration ID.
            FCM server returned an unexpected error. Please contact the SFDC support team. Contact Salesforce.
            An unexpected error occurred. Please contact the SFDC support team. Contact Salesforce.

            See Also

             
            Loading
            Salesforce Help | Article