Push notifications help you stay connected with users by sending real-time updates directly to their devices. By integrating with OneSignal, you can send important alerts such as new orders, status updates, promotions, and announcements to both customers and drivers.
This guide walks you through the steps to activate and configure the OneSignal integration for push notifications.
Note: This feature is available only for Enterprise plans with white-label apps. If you are using the Onro Customer and Driver apps, you can not set up this integration.
Before Starting
You must sign up for and have an account on OneSignal.
You must have the Admin role and have access to integrations in the Admin Center.
Step 1: Create Two Separate OneSignal Apps
You need to create two apps in OneSignal:
one for the Customer app and another for the Driver app.
Log in to the OneSignal Dashboard.
From the left sidebar, click on All Apps
Click New App / Website to go to the app creation page.
Enter a clear, descriptive name
Select one platform to start with (Google Android (FCM) or Apple iOS (APNs)).
Click Save & Continue and complete the credential setup for that platform.
Important: If you need help with Firebase configuration, iOS Bundle IDs, or credential files, contact [email protected].
Finish the initial setup and repeat the same steps to create the second app.
Step 2: Add the Second Platform
In the left sidebar, go to Settings → Push & In-App.
Click Add Platform.
Select the remaining platform:
If you started with Android → Add Apple iOS (APNs)
If you started with iOS → Add Google Android (FCM)
Configure the credentials:
Android: Upload the Firebase Service Account JSON file (strongly recommended).
iOS: Use the .p8 Authentication Key method (requires your Team ID, Key ID, and iOS Bundle ID).
Once both platforms are added, your OneSignal app will support push notifications to Android and iOS devices using the same App ID.
Repeat the same steps for the second app.
Step 3: Copy Your App IDs
Select your app from the All Apps list.
Go to Settings → Keys & IDs.
Copy the App IDs and save them somewhere we’ll need them later
Repeat for both Customer and Driver apps.
Step 4: Generate / Copy Your REST API Keys
On the same Settings → Keys & IDs page:
Scroll to the API Keys section.
If no key exists, click Add Key (or Create API Key).
Give it a meaningful name
Copy the REST API Key and save it somewhere we’ll need it later.
Copy and store the API key securely. OneSignal may only show it once after creation.
Use the App ID and app-level REST API Key/App API Key for each OneSignal app. Do not use the Organization API Key. Store the REST API Key securely because it may only be visible once after creation.
Repeat the same steps for the second app
Step 5: Complete the Integration in Admin Center
Now that you have all you need for the integration, it's time to actually set it up. To do so, navigate to Admin Center and follow the path below:
Admin Center -> Settings -> Integration -> Push Notification -> OneSignal
Enter the required info here:
Driver App
App ID: Paste the App ID you copied for the driver app in the previous step.
REST API Key: Enter the REST API Key for the driver app.
Customer App
App ID: Paste the App ID you copied for the customer app in the previous step.
REST API Key: Enter the REST API Key for the customer app.
Click Save Changes, and you're all set.
Once completed, push notifications will be enabled for both the Customer and Driver apps across Android and iOS.
You can check the logs to confirm whether the integration was successful, whether push notifications are being sent, or if there are any errors.