OneSignal Setup
Last updated
Was this helpful?
Last updated
Was this helpful?
Push Notifications require a Firebase Project. If you don't have one setup yet, click Add project and follow the directions to setup your project.
If you already have an FCM project, skip to Step 2.
If you've just created a new project, this should already be enabled by default and you can skip this step. However, if you are using an existing Firebase project, especially an older one, ensure Cloud Messaging API (V1) is enabled.
In your project, click the Gear icon next to "Project Overview" in the top left of the left-hand menu and select Project settings. Select the Cloud Messaging tab.
If Firebase Cloud Messaging API (V1) is disabled, then click the kebab menu icon on the top right corner and open the link.
On the subsequent page, click Enable. You may need to wait a few minutes for the action to propagate to Firebase systems.
Back in your Firebase Project Settings, go to the Service accounts tab.
Click Generate new private key at the bottom of the page.
You will see a warning window. Click Generate key.
Save the JSON file somewhere secure. You will need it shortly.
and click ( Generate new private key )
Settings > Platforms > Google Android (FCM) > Activate
Next to "Service Account JSON" select Choose file and upload the JSON file you downloaded from your Firebase project.
Click Save and Continue.
Select the SDK you are using for your app development and click Save & Continue.
Select Native Android
You are now connected to FCM with this OneSignal App and can send push notifications to your Android app. 🥳 Configure Your OneSignal App's Android Platform Settings
Update in Admin Panel only
Step-by-step guide to create an iOS Push Certificate
An iOS Push Certificate is required for notification delivery to all iOS apps.
An iOS mobile app. (This is not for websites / web push)
A Mac computer with Xcode 11+
Your Xcode project should have the Push Notification capability added. Otherwise your project may not be shown in the Apple Developer Center.
2.1 - Request a Certificate From a Certificate Authority
Open the Keychain Access app on your macOS system. It may be located in Applications > Utilities > Keychain Access.
Select Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority...
Next, select the Save to disk option and enter your information in the required fields.
This creates a certification request file that will be used later.
2.2 - Add Capabilities
Find and select your Identifier to enable Push Notifications, but do not click Edit.
2.3 - Select Push Notification Certificate
Under Services, select Apple Push Notification service SSL (Sandbox & Production) and click Continue.
The certificate will be applicable to both Sandbox and Production environments, so you do not need a separate key for each one.
2.4 - Select your App
Choose your App ID with matching Bundle ID from the App ID pop-up menu, and click Continue.
2.5 - Upload your Certificate Signing Request
Click Choose File.., select the CertSigningRequest file you saved in Step 2.1, click Open, and then click Continue.
Click Download to save the certificate to your computer.
2.6 - Creating a Private Key
Open the .cer file you downloaded in the last step by double-clicking on it in Finder.
After a few seconds, the Keychain Access program should open. Select Login > My Certificates, then right-click on your Apple Push Services key in the list and select Export "Apple Push Services....
Give the file a unique name using the .p12 extension, and click Save. You will have an option to protect the file with a password. If you add a password, you need to enter this same password on OneSignal.
In the OneSignal dashboard, select your app from the All Apps page, then go to Settings. Under Native App Platforms, click Apple iOS.
Select the .p12 file you exported (along with a password, if you added one) and click Save.
Note: If you used the OneSignal Provisionator tool to create a .p12 file, a password was generated for you, and is located next to the Download button.
Usually Required for Cordova/Ionic, and GoNative.
Skip if selected "Automatically manage signing" in Xcode.
If you did not select "Automatically manage signing", then follow these steps.
In your Apple Developer Account, go to Identifiers and select the Blue + button
Select App IDs and Continue
Select App and Continue
Provide a "Description" and your Explicit "Bundle ID" then press Continue
Click Register
In your Apple Developer Account, on the left to go to Profiles.
Next find any that are for your app and remove them if they do not have App Groups and Push Notifications in Enabled Capabilities:
Create a Profile by pressing the "+" button
Select the type of profile you need to create and press Continue
Then press Continue.
Select the Development or Distribution Certificate to associate with the Profile. Then click Continue.
In the , select your app, then go to:
A with .
A , if you do not already have one.
Select Identifiers in your Apple Developer Account under
If you do not see your Identifier, follow .
Next, go to and create a new certificate by clicking the blue + (plus) button.
Search for your App ID, if you do not see your App ID, check the step above.
