OneSignal API (Full)
Browse all Onesignal APIs★ Only Publicly Available OpenAPI DocumentCommunicationsPush NotificationsapiKey55 EndpointsREST
For Agents
Manage OneSignal apps, users, subscriptions, segments, templates, and notifications across push, email, and SMS through the full 55-endpoint OneSignal API.
Use for: I want to create a new OneSignal app, Send a push notification across all platforms for an app, Build a segment of users tagged 'premium', Update a user identified by their external alias
Not supported: Does not handle in-product UI personalisation, payments, or CRM contact storage — use for OneSignal app, user, segment, subscription, notification, and outcomes management only.
Jentic publishes the only available OpenAPI specification for OneSignal API (Full), keeping it validated and agent-ready. The full OneSignal API exposes 55 endpoints covering apps, notifications, segments, users, subscriptions, templates, players, organizations, and outcomes analytics. Agents and applications can create and update apps, send notifications across push, email, and SMS channels, manage user records and aliases, build and edit segments, transfer subscription ownership, and pull outcome metrics filtered by attribution, platform, and time range.
Install Jentic One Beta
Connect the OneSignal API (Full) to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the OneSignal API (Full), or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with OneSignal API (Full) API.
Create, update, and view OneSignal apps under an organization
Send push, email, and SMS notifications and pull message history
Build, edit, and delete user segments based on tags and properties
Create and update users by alias and manage subscription ownership transfers
Manage subscriptions by id or by token type and token value
Pull outcome analytics filtered by name, time range, platform, and attribution
Export player records to CSV for offline analysis or migration
Use Cases
Patterns agents use OneSignal API (Full) API for, with concrete tasks.
★ Multi-Channel Notification Campaigns
Coordinate push, email, and SMS sends from one API for a marketing campaign and inspect delivery outcomes afterwards. Notifications are created against an app, history can be pulled per message, and outcome analytics reveal conversions broken down by platform and attribution window.
Send a push notification to the 'Lapsed Users' segment under app id 'app-xyz' with heading 'We miss you' and pull the outcomes for 'click' over the next 7 days.
User and Subscription Management
Manage end-user identities through OneSignal aliases, link multiple device subscriptions to a single user, and transfer ownership when a subscription moves between accounts. POST /apps/{app_id}/users creates the user; PATCH endpoints update aliases and subscription assignments.
Create a user under app 'app-xyz' with external_id 'cust-123' and attach an existing iOS subscription id to that user.
Segmentation for Targeted Messaging
Define audience segments inside OneSignal programmatically based on tags or user properties, then reuse those segments when creating notifications. POST /apps/{app_id}/segments creates the segment, PATCH updates it, and DELETE removes it when no longer needed.
Create a segment named 'Active iOS Premium' under app 'app-xyz' filtered to platform=iOS and tag plan=premium.
Outcome and Conversion Analytics
Pull outcome metrics with platform and attribution filters to evaluate campaign performance after a send. GET /apps/{app_id}/outcomes accepts outcome names, a time range, platforms, and attribution windows, returning aggregate counts ready for reporting dashboards.
Pull outcome metrics for 'os__click' on app 'app-xyz' for the last 7 days filtered to iOS with direct attribution.
Agent-Run OneSignal Operations via Jentic
Customer engagement and marketing-ops agents drive OneSignal end to end through Jentic — sending notifications, editing segments, transferring subscriptions, and pulling outcomes — without ever holding the REST API key. Agents search by intent, load the matching schema, and execute against the OneSignal endpoint.
Use Jentic search 'create onesignal segment' to locate POST /apps/{app_id}/segments, load the schema, and execute with the segment definition.
Key Endpoints
55 endpoints — jentic publishes the only available openapi specification for onesignal api (full), keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/apps
Create a OneSignal app
GET
/apps
List apps under the organization
POST
/apps/{app_id}/segments
Create a user segment
POST
/apps/{app_id}/users
Create a user
PATCH
/apps/{app_id}/subscriptions/{subscription_id}/owner
Transfer a subscription to another user
GET
/apps/{app_id}/outcomes
Retrieve outcome analytics with filters
POST
/players/csv_export
Export player records to CSV
POST
/notifications/{message_id}/history
Retrieve message history for a notification
POST
/apps
Create a OneSignal app
GET
/apps
List apps under the organization
POST
/apps/{app_id}/segments
Create a user segment
POST
/apps/{app_id}/users
Create a user
PATCH
/apps/{app_id}/subscriptions/{subscription_id}/owner
Transfer a subscription to another user
GET
/apps/{app_id}/outcomes
Retrieve outcome analytics with filters
POST
/players/csv_export
Export player records to CSV
POST
/notifications/{message_id}/history
Retrieve message history for a notification
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
OneSignal REST API keys are stored encrypted in the Jentic vault (MAXsystem). Agents only ever hold a scoped reference, so the raw key never enters their context.
Intent-based discovery
Agents search by intent (e.g. 'create onesignal segment') and Jentic returns the matching operation across the 55-endpoint surface with its input schema attached.
Time to first call
Direct integration: 3-5 days to wrap auth, segments, users, and subscriptions. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using OneSignal API (Full) API through Jentic.
Why is there no official OpenAPI spec for OneSignal API (Full)?
OneSignal does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call OneSignal API (Full) via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the OneSignal API (Full) use?
The API uses an apiKey credential — the OneSignal REST API Key sent in the Authorization header. Through Jentic the key is held encrypted in the vault (MAXsystem) and the agent only sees a scoped reference.
Can I manage OneSignal segments programmatically?
Yes. POST /apps/{app_id}/segments creates a segment, GET lists segments, PATCH updates an existing segment, and DELETE removes it. Segments can then be referenced when sending notifications.
How do I transfer a subscription between users?
Use PATCH /apps/{app_id}/subscriptions/{subscription_id}/owner with the target user's identity. The endpoint reassigns the subscription so future activity is attributed to the new owner.
Does the OneSignal API expose outcome analytics?
Yes. GET /apps/{app_id}/outcomes returns aggregated counts for named outcomes filtered by time range, platform, and attribution window, suitable for campaign reporting.
What are the rate limits for the OneSignal API (Full)?
Rate limits are not declared in this OpenAPI spec. Consult documentation.onesignal.com for the current REST API limits, which differ by endpoint family.
How do I run a OneSignal segment update through Jentic?
Run pip install jentic, search 'update onesignal segment', then load the PATCH /apps/{app_id}/segments/{segment_id} schema and execute. Jentic injects the REST API key from its vault.
GET STARTED