OneSignal API: what you can do and how to use it with AI agents
The OneSignal API lets you send push notifications, emails, SMS and in-app messages, and manage users, segments and templates. Apps, online stores and digital products that run engagement and reactivation use it. Access is with the app's API key in OneSignal.
What the OneSignal API offers
Messages
Send push, email, SMS and in-app messages to users or segments.
Segments
Create and use segments based on behavior or attributes.
Users and subscriptions
Manage users, tags and the channels each one is subscribed to.
Templates
Reusable message templates.
Send results
Deliveries, opens and clicks for each message.
How to access the OneSignal API
- With your company’s credentialsUses the app's API key (REST API key) and the app ID, sent with the requests. Organization-level keys also exist.
- Mass sends should have approval and a volume limit.
- Respect consent and the opt-out option (for example, under GDPR).
- Keep test and production apps separate.
Official documentation: documentation.onesignal.com
What an iTeam agent does with the OneSignal API
Reviewed reactivation campaign
The agent proposes the copy and the inactive-user segment, shows the volume and sends after approval.
Operational notice
When an order changes status, the agent sends the notification to the right user with the standard template.
Reading the results
The agent compares opens and clicks from recent campaigns and indicates which send time and message worked best.
Tags from the CRM
The agent updates user tags with CRM data, such as plan or stage, to segment better.
From the credential to the agent at work, with approval
Copy the app key
In the OneSignal dashboard, copy the ID and API key of the right app.
Store it in the iTeam vault
Add the key and set limits: permitted segments, maximum volume and send hours.
Send a test first
Send to an internal test segment and only then allow real sends, with approval.
Ready-made AI teams for this work
Social media team
A month of post ideas, drafts in your brand voice and answers to comments, all approved by you before they go live.
SEO content team
Keyword research, briefs, drafts and updates to old posts, based on what people search and what Search Console shows.
Campaigns and e-mail team
Segments, e-mail flows and ads built from your customer data, with a report on what each campaign actually returned.
Questions about the OneSignal API
Is the OneSignal API free?
OneSignal has a free plan with limits, and the API is available on it. Higher volumes and advanced features are on paid plans.
Do I need to write code to use the OneSignal API with iTeam?
Not necessarily. The iTeam deployment team sets up sends and rules from OneSignal's documentation.
Can the agent create segments?
It can, if it has permission. Many companies prefer the agent to use segments marketing has already approved.
