---
title: "OneSignal REST API integration for LuumenAI"
url: "https://www.luumen.ai/integrations/onesignal-rest-api/"
entity: SoftwareIntegration
category: "Communication"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# OneSignal REST API integration for LuumenAI

Send push, email, and SMS from the terminal, with each send held for approval

## What LuumenAI can do with OneSignal REST API

LuumenAI connects to OneSignal REST API with an API token and exposes 15 tools (7 read-only · 6 write · 2 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 15 tools (7 read-only · 6 write · 2 destructive)
- Plan: available on all plans
- Category: Communication

## About OneSignal REST API with LuumenAI

Connect OneSignal and Luumen can read your apps, segments, devices, and past notifications while you work. Check who a segment covers before you message them. Look up a device that stopped receiving pushes. When it is time to send a notification, update a subscription, or remove a device, Luumen shows the exact payload first and waits for your approval. Authentication is by API key.

## Example tools

Read-only (7 in total):

- `ONESIGNAL_REST_API_FETCH_USER_IDENTITY` — Retrieve all aliases for a user identified by a specific alias.
- `ONESIGNAL_REST_API_GET_ELIGIBLE_IAMS` — Retrieve the manifest of In-App Messages that a subscription is eligible to display.
- `ONESIGNAL_REST_API_VIEW_AN_APP` — Retrieve metadata for a single OneSignal app.
- `ONESIGNAL_REST_API_VIEW_DEVICE` — Retrieve details of a specific device (player).
- `ONESIGNAL_REST_API_VIEW_DEVICES` — Retrieve a paginated list of devices (players) for a OneSignal app.
- `ONESIGNAL_REST_API_VIEW_NOTIFICATIONS` — Retrieve details of multiple notifications.
- `ONESIGNAL_REST_API_VIEW_SEGMENTS` — View segments for a OneSignal app.

Write and destructive (8 in total, approval required by default):

- `ONESIGNAL_REST_API_BEGIN_LIVE_ACTIVITY` — Start a Live Activity on OneSignal.
- `ONESIGNAL_REST_API_CREATE_NOTIFICATION` — Create and send a OneSignal push notification.
- `ONESIGNAL_REST_API_CREATE_TEMPLATE` — Create reusable message templates for push, email, and SMS channels.
- `ONESIGNAL_REST_API_CREATE_USER` — Create a OneSignal user with optional subscriptions and aliases.
- `ONESIGNAL_REST_API_DELETE_ALIAS` — Delete an alias by alias label from a OneSignal user.
- `ONESIGNAL_REST_API_DELETE_DEVICE` — Delete a device (player) from a OneSignal app.
- `ONESIGNAL_REST_API_UPDATE_DEVICE` — Update properties of an existing device.
- `ONESIGNAL_REST_API_UPDATE_SUBSCRIPTION` — Update an existing subscription's properties.

## Frequently asked questions

### How does LuumenAI connect to OneSignal REST API?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in OneSignal REST API on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 2 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to OneSignal REST API — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/onesignal-rest-api/