Android delivery errors reported by Pushwoosh come from the FCM HTTP v1 API. Google shut down the legacy FCM HTTP/XMPP send APIs on 20 June 2024, so the old GCM-era strings (InvalidRegistration, NotRegistered, MismatchSenderId, MessageTooBig, browser key vs server key advice) no longer apply to new sends and may only appear in historical reports.
| HTTP code | Error code | Description and what to do |
| 200 | Success |
The message was accepted by FCM for delivery. |
| 400 | INVALID_ARGUMENT |
Invalid request parameters or payload (wrong field name, wrong value type, malformed token). Replaces the legacy InvalidRegistration, MissingRegistration, InvalidDataKey, InvalidTtl, InvalidPackageName and MessageTooBig errors. Payload limit is 4096 bytes. |
| 401 | THIRD_PARTY_AUTH_ERROR |
FCM could not authenticate with APNs or with the Web Push service (invalid or missing APNs certificate / Web Push auth key). |
| 403 | SENDER_ID_MISMATCH |
The authenticated sender does not match the sender the device token is registered with. The Firebase project (service account JSON) uploaded to Pushwoosh belongs to a different project than the google-services.json bundled in the app. Replaces the legacy MismatchSenderId. |
| 404 | UNREGISTERED |
The device token is no longer valid: the app was uninstalled, the token was refreshed, or the app instance was unregistered from FCM. Replaces the legacy NotRegistered. Pushwoosh removes such tokens from the subscriber base. |
| 429 | QUOTA_EXCEEDED |
A sending limit was exceeded (per-device, per-topic or overall message rate). Retry with exponential backoff. |
| 500 | INTERNAL |
An unknown internal FCM error occurred. Retry with exponential backoff. |
| 503 | UNAVAILABLE |
FCM is temporarily unavailable or overloaded. Retry with exponential backoff, honouring Retry-After if present. |
| 401 / 403 | Authentication error |
The Firebase service account credentials configured for the Android platform in Pushwoosh are invalid, revoked or lack the Firebase Cloud Messaging API Admin permission. Re-upload the service account JSON in your Pushwoosh app configuration. |
| - | DISABLED_FIREBASE_API |
The Firebase Cloud Messaging API has never been used in the Google Cloud project, or it is disabled. Enable it at Google Cloud Console > Firebase Cloud Messaging API, wait a few minutes for propagation, then retry. |
Full reference: FCM error codes and the FCM HTTP v1 ErrorCode reference.
Comments
0 comments
Please sign in to leave a comment.