---
title: "OneSignal User Auth integration for LuumenAI"
url: "https://www.luumen.ai/integrations/onesignal-user-auth/"
entity: SoftwareIntegration
category: "Communication"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# OneSignal User Auth integration for LuumenAI

Check OneSignal users, devices, and segments, then change subscriptions with approval

## What LuumenAI can do with OneSignal User Auth

LuumenAI connects to OneSignal User Auth with an API token and exposes 12 tools (8 read-only · 3 write · 1 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: 12 tools (8 read-only · 3 write · 1 destructive)
- Plan: available on all plans
- Category: Communication

## About OneSignal User Auth with LuumenAI

Connect OneSignal and your agent can answer questions about who is reachable and who is not. Look up a user by alias, read a device record, check segment sizes, review broadcasts and outcomes. When something needs fixing — a stale subscription, a wrong device attribute — the change is previewed and held for your approval before it runs.

## Example tools

Read-only (8 in total):

- `ONESIGNAL_USER_AUTH_ONESIGNAL_VIEW_SEGMENT` — Retrieve the subscriber count for a specific OneSignal segment.
- `ONESIGNAL_USER_AUTH_VIEW_APP` — Retrieve details for a specific OneSignal app.
- `ONESIGNAL_USER_AUTH_VIEW_BROADCASTS` — View inbox broadcasts for a OneSignal app.
- `ONESIGNAL_USER_AUTH_VIEW_DEVICE` — Retrieve details for a specific device/player.
- `ONESIGNAL_USER_AUTH_VIEW_OUTCOMES` — View all outcomes associated with a OneSignal app.
- `ONESIGNAL_USER_AUTH_VIEW_SEGMENTS` — List all segments for an app.
- `ONESIGNAL_USER_AUTH_VIEW_USER` — Retrieve user details by alias label and ID.
- `ONESIGNAL_USER_AUTH_VIEW_USER_UNREAD_MESSAGE_COUNT` — Retrieve the unread message count for a specific user.

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

- `ONESIGNAL_USER_AUTH_CREATE_USER` — Create a new user or modify the subscriptions associated with an existing user.
- `ONESIGNAL_USER_AUTH_DELETE_ALIAS` — Remove an alias from a OneSignal user.
- `ONESIGNAL_USER_AUTH_EDIT_DEVICE` — Update an existing OneSignal device (player) record.
- `ONESIGNAL_USER_AUTH_UPDATE_SUBSCRIPTION_BY_TOKEN` — Update properties on an existing subscription using its token.

## Frequently asked questions

### How does LuumenAI connect to OneSignal User Auth?

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 User Auth on its own?

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

### Is there an audit trail?

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

Full page: https://www.luumen.ai/integrations/onesignal-user-auth/