---
schema_version: "1"
id: 13a2d2d068845b28d721c302dacf708b91f1eaf7088b05ca1b284e660da23cf4
title: Error Messages for 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_push_errors.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.connected_app_push_errors.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: edbba9a3b20358b5e019b0bc9f7d2a5c7b94ca1e33b3386ed0982b2c749ab251
description: 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.
products:
  - Security
  - Cross Cloud
release: "264"
---
# 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](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.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
          <colgroup>
            <col style="width:50%">
            <col style="width:50%">
          </colgroup>
          <thead class="slds-text-title_caps ">
            <tr class="">
              <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d32609e54">Message</th>
              <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d32609e57">Suggested Resolution</th>
            </tr>
          </thead>
          <tbody>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Certificate
                is not accepted by Apple Push Notification service</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Replace the certificate with
                a valid type.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Certificate
                is revoked</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Supply a valid
                certificate.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Certificate
                expired</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Renew a certificate.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Certificate
                not valid yet</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Retry later.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Invalid certificate
                or password</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Replace the
                certificate with a valid type.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Invalid recipient
                or payload</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Check your
                input for errors.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Payload exceeds
                maximum size</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Reduce the size of the
                payload.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Unable to load
                push notifications settings</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Confirm that the settings are
                present on the external client app.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Recipient field
                contains invalid device token</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Provide a valid device
                token.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Invalid device
                token length</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Token was entered incorrectly
                or is corrupt. Re-enter the token.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Error while
                sending notification. Confirm certificate is for the correct Apple
                environment.</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Confirm that the correct
                certificate is being used (for example, sandbox versus production).</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Apple Push
                Notification service is unavailable.</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Retry later.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Unable to connect
                to Apple Push Notification service</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Retry later.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Unable to connect
                to Salesforce proxy. Contact Salesforce support if issue persists.</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Retry later.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Request blocked
                by Salesforce proxy. Contact Salesforce support if issue persists.</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Retry later.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Apple Push
                Notification service returned unknown error</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Contact Apple
                or retry later.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Badge must
                be a number</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Re-enter the
                badge value as an integer.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Payload must
                be in a valid JSON format</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Format the payload
                correctly.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">You must enter
                a value for at least one of the following fields: Alert, Badge, Sound,
                or Custom Payload</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Enter a valid
                value for one of the fields.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Recipient is
                required</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Provide a device
                token.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Firebase Cloud Messaging authentication
                error</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">
                <p>Consult the FCM documentation at <a href="https://developer.android.com" target="_blank">developer.android.com</a>. Possible causes:</p>
                <ul>
                  <li>
                    <p>Authorization header is missing or contains invalid syntax.</p>
                  </li>
                  <li>
                    <p>Invalid project number was sent as key.</p>
                  </li>
                  <li>
                    <p>Key is valid, but FCM service is disabled.</p>
                  </li>
                  <li>
                    <p>Request originated from a server that is not white-listed in the server key
                      IP addresses.</p>
                  </li>
                </ul>
              </td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Internal error in the Firebase Cloud
                Messaging server, or the server is temporarily unavailable</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Retry later.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Registration
                ID in the Recipient field is formatted incorrectly</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Verify that the mobile app is
                providing valid registration ID, or manually enter valid registration ID.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Payload exceeds
                maximum size</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Reduce the size of the
                payload.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">&nbsp;</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">&nbsp;</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Recipient is
                required</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Select a recipient or provide
                registration ID.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">Recipient field
                contains invalid registration ID</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Update the recipient’s device
                registration ID.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">FCM server returned an unexpected error.
                Please contact the SFDC support team.</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Contact Salesforce.</td>

            </tr>
            <tr class="">
              <td data-label="Message" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e54 ">An unexpected error occurred. Please contact
                the SFDC support team.</td>

              <td data-label="Suggested Resolution" class="slds-cell-wrap" rowspan="1" colspan="1" style="vertical-align:top;" headers="d32609e57 ">Contact Salesforce.</td>

            </tr>
          </tbody>
        </table>

#### See Also

- [Test Push Notifications](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_test_push.htm&release=264.0.0&type=5 "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.")