Apple watchOS Setup

OneSignal supports push notifications for Apple Watch apps in two ways: synced notifications from paired iOS apps and standalone watchOS app implementations.

Synced Notifications

When an iOS mobile app is synced to a watchOS app, notifications sent to the iPhone will automatically appear on the paired Apple Watch.

Standalone watchOS Implementation

For standalone watchOS apps, you can implement push notifications independently. While OneSignal doesn’t provide a dedicated SDK for standalone watchOS apps, you can integrate using the following approach:

1

Register for Remote Notifications

Implement the Apple WatchKit WKExtension with the registerForRemoteNotifications method. This generates the APNs push token specifically for the watch device.

2

Handle Token Registration

Set up the WKExtensionDelegate to capture the APNs push token using the didRegisterForRemoteNotificationsWithDeviceToken method.

3

Register Device with OneSignal

Create the subscription in OneSignal using the Add a device API with these required properties:

Required Parameters:

  • identifier: The APNs push token generated by the watch
  • device_type: Set to 0 for iOS devices
  • external_user_id: Unique identifier for the user who owns this subscription

Optional Parameters:

  • test_type: Required only when testing on development or ad-hoc builds
  • Additional properties as needed for your implementation
4

Send Notifications

Once the device is registered, you can send push notifications directly to the watch through OneSignal’s dashboard or API.


Android Wear OS Setup

The OneSignal Android Native SDK is fully compatible with Android Wear OS applications, providing seamless integration without additional configuration.

Custom Notifications

You can enhance the watch experience by building:

  • Custom notification layouts optimized for wearable displays
  • Wearable-specific actions and interactions
  • Watch-only notification behaviors

Follow the official Android Developer Notifications on Wear OS documentation for detailed implementation guidance on creating rich, interactive notifications tailored for wearable devices.

Implementation Notes

  • Use the same OneSignal Android SDK as mobile apps
  • No additional setup required for basic functionality
  • Custom layouts and actions require standard Android Wear OS development practices