You're Viewing User Model Beta Documentation 🎉

OneSignal is in the process of migrating from a device-centric model (player ID) to a new user-centric data model (OneSignal ID). In the new user-centric world, Users have a OneSignal ID, and what was the player ID is now known as the Subscription ID.

To learn more, check out the User Model Beta Overview.

Please refer to Version 9 of our documentation for device-centric information.

This endpoint is used to create or update an alias for a user. The subscription_id path parameter is used to identify the User. The request body must contain identity, an IdentityObject containing one or more aliases to be created.

This endpoint behaves like an upsert, i.e. if the user already has an alias with the given alias_label, the alias will be updated. If the user does not have this alias_label, the alias will be created.

Aliases are updated synchronously.

onesignal_id cannot be updated.

This endpoint behaves identically to Create alias but identifies the user with a subscription_id rather than alias_label and alias_id pair.