v1
latestOpenAPI 3.1.02026-07-26497885.9 KBCreate Subscription by alias
Use this API to attach a new subscription—such as email, SMS, or push notification—to an existing OneSignal user identified by an alias.
post/apps/{app_id}/users/by/{alias_label}/{alias_id}/subscriptions
Path parameters
app_idstring required
Your OneSignal App ID in UUID v4 format. See Keys & IDs.
alias_labelstring required
The alias name or key to locate the user. Most commonly set as external_id but can be the onesignal_id or a custom alias.
alias_idstring required
The specific identifier for the given alias to identify the user.
Headers
Authorizationstring required
Your App API key with prefix Key . See Keys & IDs.
Request body
Response
200
object required