​
Configure your OneSignal app and platform

To send push notifications on macOS, your OneSignal app must be configured with Apple (APNs).
If your team already has a OneSignal account, ask to be invited as an admin role so you can configure the app. Otherwise, sign up for a free account to get started.

​
1. Create or select your app

  • Select your app and go to Settings > Push & In-App.
  • Or create a new app by clicking New App/Website.

Example shows creating a new app.

​
2. Set up and activate macOS platform

  • Choose a recognizable app and organization name.
  • Select (More Options) macOS as the platform to activate.
  • Click Next: Configure Your Platform.

Example setting up your first OneSignal app, org, and channel.

​
3. Configure credentials

Follow the prompts to add either:

Example showing the p8 Auth Key configuration page.

Click Save & Continue after entering your credentials.

​
4. Save your App ID

You’ll be shown your OneSignal App ID — make sure to save it, as you’ll need it during setup.

Save your App ID for setup.

​
Setup

If your macOS app was built with Mac Catalyst, you can integrate our iOS SDK directly. Otherwise, you can leverage our APIs to manage users and notifications.
If you built your app with Mac Catalyst, you can integrate our iOS SDK directly.
macOS setup complete! Recommended next steps: