iOS, OS X, Safari errors

Descriptions and solutions to common errors that may occur on iOS, OS X, and Safari platforms

ErrorDescriptionWhat to do

BadCertificate

The APNS certificate for this application is invalid.

Create a valid certificate using this guide and check that the platform is configured correctly.

BadDeviceToken

The specified device token is invalid. Therefore, the device will be unsubscribed from notifications.

Verify that the request contains a valid token and that the token matches the environment.

DeviceTokenNotForTopic

The specified token is unsuitable for sending notifications to the specified topic (package name specified when creating the iOS app). The device will be unsubscribed from notifications.

Use the token that is suitable for sending notifications to this topic.

ExpiredCertificate

The APNS certificate for this application has expired.

Create a valid certificate using this guide and check that the platform is configured correctly.

FrequencyCapping

The device was filtered by Frequency Capping.

If such behavior was not intended, check the Frequency Capping settings.

InvalidCertificate

The APNS certificate for this application is invalid.

Create a valid certificate using this guide and check that the platform is configured correctly.

InvalidProviderToken

The specified token is invalid or signed with an invalid certificate. Notifications will no longer be sent to the platform where this error occurred.

Check that the platform is configured correctly.

InvalidToken

The specified token is invalid. Notifications will no longer be sent to the platform where this error occurred.

Check that the platform is configured correctly.

This error usually points to the mismatch between gateways (for example, if you're sending pushes to your development/sandbox build through the production gateway or vice versa). Also, some of your users may have another build installed on their devices.

MissingDeviceToken

The device token isnโ€™t specified in the request.

Verify that the header contains the device token.

PayloadIsTooLarge

The message size exceeds 4096 bytes.

Reduce the message size.

RevokedCertificate

The APNS certificate for this application has been revoked via the Apple Developer admin panel. Push notifications will be disabled for this platform.

Renew your certificate using this guide.

SandboxSendingError

Failed to send message to the sandbox APNS environment.

Try sending the message again later.

TimeoutExceeded

Multiple attempts to send a message to the device within 1 hour were unsuccessful, as the APNS server did not respond.

Try sending the message again later.

Unregistered

The token is no longer valid. The device will be unsubscribed from notifications.

Use a new token.

Last updated

#1685:

Change request updated