Developer guides · Push

Push notification guides

Push notifications on Android go through Firebase Cloud Messaging (FCM), and on iOS through Apple Push Notification service (APNs), usually with FCM in front. These guides cover the setup in Flutter and React Native, the permissions each platform asks for, and what each FCM and APNs error code means and how to fix it.

FCM and APNs error codes

What each error returned by FCM or APNs means, and whether to delete the device token. Each code links to a full guide.

ErrorReturned byWhat it means
UNREGISTEREDFCM 404The token is no longer valid, for example after the app was uninstalled
INVALID_ARGUMENTFCM 400The payload or the token is invalid. Check the payload before deleting the token
SENDER_ID_MISMATCHFCM 403The server sends from a different Firebase project than the token belongs to
THIRD_PARTY_AUTH_ERRORFCM 401Firebase can't authenticate with APNs: missing, revoked or expired APNs key or certificate
BadDeviceTokenAPNs 400The token is invalid or was sent to the wrong environment (sandbox vs production)
No APNS token specifiediOS appThe app asked for an FCM token before iOS gave it an APNs token
PERMISSION_DENIEDFirebase AI Logic 403App Check enforcement is on and the request has no valid App Check token