# OneSignal User Auth

OneSignal is a customer engagement platform offering push notifications, email, SMS, and in-app messaging services.

- **Category:** notifications
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `ONESIGNAL_USER_AUTH`
- **Version:** 20260414_00

## Tools

### Create or Update OneSignal User

**Slug:** `ONESIGNAL_USER_AUTH_CREATE_USER`

Tool to create a new user or modify the subscriptions associated with an existing user. Use when you need to register a user with OneSignal or update their subscriptions.

### Delete User Alias

**Slug:** `ONESIGNAL_USER_AUTH_DELETE_ALIAS`

Tool to remove an alias from a OneSignal user. Use when you need to delete a specific alias identifier from a user while preserving other aliases. The user is identified by one alias (alias_label/alias_id) and a different alias (alias_label_to_delete) is removed.

### Edit OneSignal Device

**Slug:** `ONESIGNAL_USER_AUTH_EDIT_DEVICE`

Tool to update an existing OneSignal device (player) record. Use when you have the player_id and need to modify device attributes.

### View OneSignal Segment

**Slug:** `ONESIGNAL_USER_AUTH_ONESIGNAL_VIEW_SEGMENT`

Tool to retrieve the subscriber count for a specific OneSignal segment. Use when you need to know how many subscribers are in a segment.

### Update Subscription By Token

**Slug:** `ONESIGNAL_USER_AUTH_UPDATE_SUBSCRIPTION_BY_TOKEN`

Tool to update properties on an existing subscription using its token. Use when you need to enable or disable subscription status when managing outside of the OneSignal SDK.

### View App

**Slug:** `ONESIGNAL_USER_AUTH_VIEW_APP`

Tool to retrieve details for a specific OneSignal app. Use after authenticating to inspect app settings.

### View Broadcasts

**Slug:** `ONESIGNAL_USER_AUTH_VIEW_BROADCASTS`

Tool to view inbox broadcasts for a OneSignal app. Returns broadcasts in descending order of creation. Use when retrieving in-app messages or inbox content for an app.

### View OneSignal Device

**Slug:** `ONESIGNAL_USER_AUTH_VIEW_DEVICE`

Tool to retrieve details for a specific device/player. Use when you have a player_id and optional app_id.

### View Outcomes

**Slug:** `ONESIGNAL_USER_AUTH_VIEW_OUTCOMES`

Tool to view all outcomes associated with a OneSignal app. Use to retrieve outcome metrics filtered by time range, platforms, and attribution type.

### View Segments

**Slug:** `ONESIGNAL_USER_AUTH_VIEW_SEGMENTS`

Tool to list all segments for an app. Use after obtaining the app_id to retrieve a paginated list of segments.

### View OneSignal User

**Slug:** `ONESIGNAL_USER_AUTH_VIEW_USER`

Tool to retrieve user details by alias label and ID. Use when you need to fetch user data including tags, subscriptions, and identity information.

### View User Unread Message Count

**Slug:** `ONESIGNAL_USER_AUTH_VIEW_USER_UNREAD_MESSAGE_COUNT`

Tool to retrieve the unread message count for a specific user. Use when you need to check how many unread inbox messages a user has.