# OneSignal REST API

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

- **Category:** notifications
- **Auth:** API_KEY
- **Tools:** 8
- **Triggers:** 0
- **Slug:** `ONESIGNAL_REST_API`
- **Version:** 20260211_00

## Tools

### Create Notification

**Slug:** `ONESIGNAL_REST_API_CREATE_NOTIFICATION`

Tool to create and send a OneSignal push notification. Use when you have your message and target audience ready to dispatch notifications.

### Delete Device

**Slug:** `ONESIGNAL_REST_API_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.

### Update Device

**Slug:** `ONESIGNAL_REST_API_UPDATE_DEVICE`

Tool to update properties of an existing device. Use when you need to modify device attributes after registration.

### View OneSignal App

**Slug:** `ONESIGNAL_REST_API_VIEW_AN_APP`

Tool to retrieve metadata for a single OneSignal app. Use when you need to fetch app details by its ID.

### View Device

**Slug:** `ONESIGNAL_REST_API_VIEW_DEVICE`

Tool to retrieve details of a specific device (player). Use when you have a OneSignal player_id and need current device info.

### View Devices

**Slug:** `ONESIGNAL_REST_API_VIEW_DEVICES`

Tool to retrieve a paginated list of devices (players) for a OneSignal app. Use when you need to list or audit all registered devices for a given app.

### View Notifications

**Slug:** `ONESIGNAL_REST_API_VIEW_NOTIFICATIONS`

Tool to retrieve details of multiple notifications. Use when you need to list notifications for a specific app.

### View Segments

**Slug:** `ONESIGNAL_REST_API_VIEW_SEGMENTS`

Tool to view segments for a OneSignal app. Use when you need to list all segments associated with an app.
