Why are my Android push notifications not being delivered after integrating the SDK?

If Android push notifications are not arriving on your test device, review these configuration points:

1. Incorrect Pushwoosh Application Code: verify that the com.pushwoosh.appid metadata value in your AndroidManifest.xml exactly matches the Application Code of the project you configured in the Pushwoosh Control Panel. Using another app's code (for example the Demo App's) causes delivery failures.

   <!-- Inside the <application> tag in AndroidManifest.xml -->
   <meta-data
       android:name="com.pushwoosh.appid"
       android:value="YOUR_PUSHWOOSH_APP_CODE" />
   

2. Missing Device API token: the current SDK (6.10.0) authorizes its requests with a Device API token. Without it, registration fails with 401 and no device appears in Pushwoosh. Get the token in Settings → API Access and add it to the manifest.

   <meta-data
       android:name="com.pushwoosh.apitoken"
       android:value="YOUR_DEVICE_API_TOKEN" />
   

   Note: com.pushwoosh.senderid is no longer used. Legacy FCM (Server Key / Sender ID) was shut down by Google in June 2024 — remove those values if you still carry them.

3. Incomplete Firebase configuration in Pushwoosh: in the Control Panel open your project → Configure platforms → Android, and upload the JSON private key (service account) generated in the Firebase console under Project settings → Service accounts → Generate new private key. Also make sure the Firebase Cloud Messaging API (V1) is enabled for that Google Cloud project, and that the google-services.json bundled in your app belongs to the same Firebase project.
4. Device not registered: check the device logs at app start for a successful registration, and confirm the device appears in the Audience section of the Control Panel.
5. Device or network issues: stable internet connection, notifications enabled for the app in Android settings, and background data / battery optimization not blocking delivery.
6. Incorrect targeting: when sending a test message, make sure you target that device (by HWID or as a test device) or a segment the device actually belongs to.