Skip to main content
The OneSignal mobile SDK enables push notifications, in-app messages, and Live Activities in your iOS, Android, Huawei, and Amazon apps. Setup has two steps:
  1. Configure platform credentials: connect your FCM, APNs, HMS, or ADM credentials to OneSignal
  2. Integrate the SDK: install the OneSignal SDK for your platform and initialize it in your app
For websites, see Web SDK setup.

​
Configure your OneSignal app and platform

Configure your OneSignal app with the platforms you support — Apple (APNs), Google (FCM), Huawei (HMS), and/or Amazon (ADM).
If your organization already has a OneSignal account, ask to be invited to the Organization. Otherwise, sign up for a free account to get started.
1

Create or select your app

Create a new app by clicking New App/Website, or add a platform to an existing app in Settings > Push & In-App. Select the platform(s) you want to configure and click Next: Configure Your Platform.
OneSignal dashboard showing the new app setup flow with Organization name, app name, and channel selection

Setting up your first OneSignal app, Organization, and channel.

2

Configure platform credentials

Enter the credentials for your platform:Click Save & Continue after entering your credentials.
3

Save your App ID and install the SDK

Your App ID is displayed on the final screen. Copy and save it — you need it when initializing the SDK. Select your SDK platform, then follow the setup guide.
OneSignal dashboard showing the App ID and team invite option after setup

Save your App ID and invite additional team members.

​
Integrate the SDK

Android native

Native Android apps using FCM.

iOS native

Native iOS apps using APNs.

Amazon Fire OS

Amazon Fire OS apps using ADM.

Huawei

Huawei devices using HMS.

React Native

Bare React Native apps.

Expo

Managed Expo apps with EAS Build.

Flutter

Flutter apps using Dart.

Unity

Unity apps for iOS, Android, Amazon, and Huawei.

.NET MAUI

.NET MAUI apps for iOS and Android.

Cordova

Cordova and Ionic Cordova hybrid apps.

Capacitor

Capacitor and Ionic Capacitor hybrid apps.

​
Other integrations

FlutterFlow

Low-code FlutterFlow apps.

Median.co

Median.co (formerly GoNative.io) web-to-app apps.

​
After setup

Identify Users, test delivery, and look up SDK methods as you build.

Users

Call login with an External ID to identify Users across devices and channels.

Test Users

Verify delivery, rendering, and deep links before sending to your full audience.

Mobile SDK reference

Methods, classes, and event hooks for iOS, Android, and cross-platform SDKs.

Mobile troubleshooting

Resolve common push delivery, APNs, and in-app messaging issues.

​
SDK versions

​
FAQ

​
Do I need separate OneSignal apps for iOS and Android?

No. A single OneSignal App supports multiple platforms: iOS, Android, Huawei, Amazon, and web. Configure each platform’s credentials in Settings > Push & In-App and they all share the same app, users, and segments.

​
Can devices in China or on Huawei receive push notifications?

If the device has Google Play Services, it receives push through FCM. If the app was downloaded from the Huawei AppGallery (including non-HarmonyOS Huawei devices running Android), it receives push through HMS. Set up the Huawei SDK to enable this. OneSignal defaults to FCM for devices that support both HMS and FCM. You can prefer HMS over FCM if needed.