Connect OneSignal
PushPilot integrates with OneSignal to send push notifications via your existing OneSignal apps. There are two ways to connect: Discover via Organisation Key (recommended if you have multiple apps) or Direct Connect (single app, fastest).
How PushPilot uses OneSignal
PushPilot calls the OneSignal REST API to create and send notifications. Your app continues to use the OneSignal SDK — PushPilot only needs the App ID and the REST API Key (also called the Channel Auth Key or API Key) for each app. Credentials are encrypted with AES-256 before being stored.
Method A — Discover via Organisation Key
Best when you manage multiple OneSignal apps under one account.
- 1
Find your OneSignal Organisation API key
In the OneSignal Dashboard , click your account name in the top-right → Organisation Settings. Under Keys & IDs, copy the Organisation API Key.
Organisation Key vs App Key
The Organisation API Key lets PushPilot list all your apps for discovery. It is different from the per-app REST API Key (Channel Auth Key) used for sending. You will add the per-app key in step 3. - 2
Discover apps in PushPilot
In the PushPilot dashboard go to Integrations → OneSignal → Discover Apps. Paste your Organisation API Key and click Discover. PushPilot will list all apps in your OneSignal account. Select the ones you want to connect and click Import Selected.
- 3
Add the REST API key for each app
After importing, each app is listed under Integrations with a Pending Key badge. Click Set API Key and enter the app-level REST API Key.
To find the per-app key: in OneSignal Dashboard, open the app → Settings → Keys & IDs. Copy the REST API Key (not the App ID).
Method B — Direct Connect
Best for a single app or when you already have the App ID and REST API Key handy.
- 1
Get your App ID and REST API Key
In OneSignal: Settings → Keys & IDs.
- OneSignal App ID — a UUID like
a1b2c3d4-... - REST API Key — starts with
os_v2_app_...
- OneSignal App ID — a UUID like
- 2
Connect in PushPilot
Go to Integrations → OneSignal → Direct Connect. Enter your App ID and REST API Key, then click Connect. PushPilot validates the credentials and creates the integration immediately.
Syncing segments as topics
OneSignal Segments are the equivalent of FCM topics — they define which users receive a notification. PushPilot imports your OneSignal segments as Topics so you can assign them to campaigns.
- 1
Go to Integrations → OneSignal → [your app] → Sync Segments.
- 2
PushPilot fetches all segments from OneSignal and creates matching Topic records in your workspace. These are then available when creating campaigns.
- 3
Re-run sync whenever you add new segments in OneSignal. Existing topics are not duplicated.
Creating segments via AI
Test the connection
After connecting, click Test next to the project name. PushPilot sends a test notification via the OneSignal API to verify that the App ID and REST API Key are correct.