If you are having issues with your website and no mobile apps, see our Web Push Troubleshooting guide.

Troubleshooting steps

1. Review setup instructions and update the OneSignal SDK

Our Mobile SDK setup instructions are designed to help prevent common issues and test the integration. We frequently release updates with bug fixes, improvements, and support for the latest operating system changes. If you’re experiencing issues, first ensure you are using our latest SDK version and followed the setup instructions.

2. Common troubleshooting guides

3. Test the example project for your SDK

Check to see if your issue is reproducible using the build created by our engineering team for each SDK .

4. Check the error logs

Before diagnosing issues, it’s important to gather log data:
  • Follow our guide on capturing a debug log.
  • Look for errors, warnings, or deprecation notices that could explain the behavior.

5. Contact support

If you are still having issues:
  • Contact support@onesignal.com with:
    • Your OneSignal App ID.
    • Your External ID and/or Subscription ID of the device you are experiencing the issue on.
    • The notification ID or a link to the notification in the OneSignal Dashboard if applicable.
    • A debug log from the device reproducing the issue if possible.

Common errors

APNS Delegate never fired

APNS Errors like “Apns Delegate Never Fired” and “APNS 3000”, are timeout messages provided by Apple indicating that the device could not make a connection with Apple’s APNS servers required for push notifications. This is most common when:
  • Testing on APNS development environments
  • If you use multiple push notification dependencies or native iOS push APIs with OneSignal
  • Temporary error that self resolves the next time the user starts a new session (app put out of focus for 30+ seconds, then opened again).
Steps to resolve:
  • Remove any other push notification dependencies or native iOS push APIs and only use OneSignal. Once the error resolves, you can try adding back the other code and contact support@onesignal.com for best practices.
  • Check the debug log from the device for more details.
  • If the error persists, follow these steps to contact support.

FAQ

What happens if I change my OneSignal App ID in my app?

Changing the OneSignal App ID in your app’s initialization code will create a brand new user and push subscription under the new App ID when the user updates and opens the app to the latest version. If your iOS bundle ID and/or Android package ID are the same, then the device will continue with the same push subscription status. The user data will be brand new i.e. you will need to add back your aliases, tags, email address, phone number on the new record. If the iOS bundle ID or Android package ID are different, then this this a brand new app and should have different push certs/keys.

Can OneSignal send push notifications in an on-premise closed network?

This can work as long as the computers on your closed network have access to the push gateway servers that you want to support: If the network is completely disconnected from the Internet, push notifications cannot be delivered via the standard OS/browser services, which is what we support.