Hey! These docs are for version 7.0, which is no longer officially supported. Click here for the latest version, 9.0!

## Required For Setup

  • [A OneSignal account](🔗) if you do not already have one

  • Your OneSignal App ID, available in [Keys & IDs](🔗)

## macOS Setup

### Option 1: Mac Catalyst

If you built your app with Mac Catalyst, you can setup [OneSignal's XCFramework SDK](🔗).

More details in this [guide on our blog](🔗).

### Option 2: API

OneSignal does not currently have a dedicated macOS SDK. However, OneSignal can be used to send notifications to macOS apps. Please refer to [Apple's documentation](🔗) to learn how to obtain a push token.

To register a macOS device, call OneSignal's [Add a Device POST /players](🔗) with a `device_type` of `9` to represent the macOS platform, and pass in the push token for the `identifier` parameter.

### Updating User Events

With the [Add a Device POST /players](🔗) you can set your own custom `external_user_id` and update custom data (called [Data Tags](🔗) with the [Edit tags with external user id](🔗).

Otherwise, you can save the OneSignal `player_id` provided in the response to update device data with [Edit device](🔗) or [New session](🔗).