Why does the API return an 'UnknownUsers' error when I send a push using a User ID?

This error indicates that the User ID specified in your /createMessage API request is not associated with any active, registered device in your Pushwoosh application. Sending notifications to a User ID will only work if that ID has been successfully linked to a device's hardware ID (HWID).

Here are the steps to troubleshoot this issue:

1. Verify User ID Association

   • Go to the User Explorer section in your Pushwoosh Control Panel.
   • Search for the User ID you are trying to target. If the search returns no results, or if the associated device shows as 'Unregistered', it means the User ID was not set correctly or the user has unsubscribed.

2. Check Your Client-Side Code

   • Confirm that you are calling the setUserId("YOUR_USER_ID") method from the Pushwoosh SDK in your application's code.
   • This method must be called after the user is logged in or identified in your app, and after the registerDevice method has successfully completed.

3. Review SDK Documentation

   • Double-check the official Pushwoosh documentation for the specific SDK you are using (e.g., Capacitor, native iOS, React Native). The implementation details for setUserId can vary. Ensure you are following the documented method signature and sequence correctly.

After you have confirmed your client-side code is correctly setting the User ID, you can verify the association again in the User Explorer. Once an active device is linked to the User ID, API calls targeting that user should succeed.