ToolkitSuiteApps"Connect OneSignal account"
Features

"Connect OneSignal account"

How to connect your OneSignal account with your app?

Connect their own OneSignal account to gain better control over push notifications. This allows you to manage and send notifications directly from your own OneSignal dashboard.

Connecting your own OneSignal account is available only on the Premium plan.

Step 1: Enable OneSignal authentication

  • Locate Use my own OneSignal account.
  • Turn the toggle On.

Once enabled, you will be able to enter your OneSignal credentials.

Step 2: Get your OneSignal credentials

  • Log in to your OneSignal account.
  • From the side menu, open Organization.
  • Under Organization, go to Keys & IDs from the side menu.
  • Copy the Organization ID shown under the OneSignal Organization ID section.
  • Go back to your app dashboard and paste it into the OneSignal Organization ID field.
  • Click the Add key button.
  • In the pop-up, enter a name for the key.
  • Generate the key and copy it.
  • Return to your app dashboard and paste the copied key into the OneSignal Organization API Key field.

The Organization API Key is displayed only once when created. Make sure to copy and store it securely.

Step 3: Save and verify setup

  • Click Save.
  • Click Verify to authenticate your OneSignal account.

If successful, the status will display as Connected. If verification fails, you may see the message:

“Unable to verify OneSignal account. The provided credentials may be incorrect or the account may be temporarily unavailable.”

In this case, recheck your credentials and verify again.

Change or disable OneSignal configuration

By default, your app uses the Apps OneSignal account.

If you switch between the default Apps OneSignal account and your own OneSignal account, the following will occur:

  • When switching from Apps OneSignal to your own OneSignal account
  • All previously scheduled notifications will automatically move to Draft.
  • Existing segments may no longer apply.
  • You may need to recreate segments in your own OneSignal account.
  • When switching back to the Apps OneSignal account
  • Notifications created under your own OneSignal account will remain in Draft.
  • Segments associated with the Apps OneSignal account will become available again.

A confirmation pop-up will appear before changing this setting.

After changing the OneSignal configuration, you will need to rebuild and republish your app for the changes to take effect.

Need more help?

If you've worked through this and still need a hand, contact support — we'll dig in with you.