# OneSignal REST API AI integration on Definable

> The OneSignal REST API enables developers to programmatically send push notifications, emails, and SMS, manage users and subscriptions, and configure apps.

## What this connects

The OneSignal REST API enables developers to programmatically send push notifications, emails, and SMS, manage users and subscriptions, and configure apps.

Vendor: https://onesignal.com/

## Tools available

**15** tools available. First 12:

- `ONESIGNAL_REST_API_BEGIN_LIVE_ACTIVITY` — Begin Live Activity — Tool to start a Live Activity on OneSignal. Use when you need to initiate a Live Activity session with a push token and subscription ID.
- `ONESIGNAL_REST_API_CREATE_NOTIFICATION` — Create Notification — Tool to create and send a OneSignal push notification. Use when you have your message and target audience ready to dispatch notifications.
- `ONESIGNAL_REST_API_CREATE_TEMPLATE` — Create Template — Tool to create reusable message templates for push, email, and SMS channels. Use when you need to create a template that can be accessed through both the dashboard and API using a template_id.
- `ONESIGNAL_REST_API_CREATE_USER` — Create User — Tool to create a OneSignal user with optional subscriptions and aliases. Aliases provided in the payload will be used to look up an existing user.
- `ONESIGNAL_REST_API_DELETE_ALIAS` — Delete Alias — Tool to delete an alias by alias label from a OneSignal user. Use when you need to remove a specific alias identity from a user's profile.
- `ONESIGNAL_REST_API_DELETE_DEVICE` — Delete Device — Tool to delete a device (player) from a OneSignal app. Use when you need to remove a specific device by its player ID.
- `ONESIGNAL_REST_API_FETCH_USER_IDENTITY` — Fetch User Identity — Tool to retrieve all aliases for a user identified by a specific alias. Use when you need to fetch the complete identity mapping for a OneSignal user.
- `ONESIGNAL_REST_API_GET_ELIGIBLE_IAMS` — Get Eligible In-App Messages — Tool to retrieve the manifest of In-App Messages that a subscription is eligible to display. Use when you need to fetch eligible IAMs for a specific subscription.
- `ONESIGNAL_REST_API_UPDATE_DEVICE` — Update Device — Tool to update properties of an existing device. Use when you need to modify device attributes after registration.
- `ONESIGNAL_REST_API_UPDATE_SUBSCRIPTION` — Update Subscription — Tool to update an existing subscription's properties. Use when you need to modify subscription attributes like token, enabled status, or device information.
- `ONESIGNAL_REST_API_VIEW_AN_APP` — View OneSignal App — Tool to retrieve metadata for a single OneSignal app. Use when you need to fetch app details by its ID.
- `ONESIGNAL_REST_API_VIEW_DEVICE` — View Device — Tool to retrieve details of a specific device (player). Use when you have a OneSignal player_id and need current device info.

## Auth

Auth schemes: `API_KEY`.

## How agents use OneSignal REST API

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

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

The Verifier checks every OneSignal REST API 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_rest_api/
- 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