# OneSignal User Auth AI integration on Definable

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

## What this connects

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

Vendor: https://onesignal.com

## Tools available

**12** tools available. First 12:

- `ONESIGNAL_USER_AUTH_CREATE_USER` — Create or Update OneSignal 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.
- `ONESIGNAL_USER_AUTH_DELETE_ALIAS` — Delete User 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.
- `ONESIGNAL_USER_AUTH_EDIT_DEVICE` — Edit OneSignal Device — Tool to update an existing OneSignal device (player) record. Use when you have the player_id and need to modify device attributes.
- `ONESIGNAL_USER_AUTH_ONESIGNAL_VIEW_SEGMENT` — View OneSignal 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.
- `ONESIGNAL_USER_AUTH_UPDATE_SUBSCRIPTION_BY_TOKEN` — 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.
- `ONESIGNAL_USER_AUTH_VIEW_APP` — View App — Tool to retrieve details for a specific OneSignal app. Use after authenticating to inspect app settings.
- `ONESIGNAL_USER_AUTH_VIEW_BROADCASTS` — 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.
- `ONESIGNAL_USER_AUTH_VIEW_DEVICE` — View OneSignal Device — Tool to retrieve details for a specific device/player. Use when you have a player_id and optional app_id.
- `ONESIGNAL_USER_AUTH_VIEW_OUTCOMES` — 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.
- `ONESIGNAL_USER_AUTH_VIEW_SEGMENTS` — View Segments — Tool to list all segments for an app. Use after obtaining the app_id to retrieve a paginated list of segments.
- `ONESIGNAL_USER_AUTH_VIEW_USER` — View OneSignal 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.
- `ONESIGNAL_USER_AUTH_VIEW_USER_UNREAD_MESSAGE_COUNT` — 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.

## Auth

Auth schemes: `API_KEY`.

## How agents use OneSignal User Auth

Inside a Definable workflow, OneSignal User Auth is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → OneSignal User Auth** — the Researcher (GPT-5.5) pulls context from OneSignal User Auth (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → OneSignal User Auth** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into OneSignal User Auth (create record, post message, draft email).
- **Designer / Engineer → Distributor → OneSignal User Auth** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via OneSignal User Auth (attach file, open PR comment, post status).

The Verifier checks every OneSignal User Auth call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- notifications — https://definable.ai/apps/category/notifications/
- phone & sms — https://definable.ai/apps/category/phone-&-sms/

## Related

- HTML page: https://definable.ai/apps/onesignal_user_auth/
- Same category (notifications): https://definable.ai/apps/category/notifications/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt