OneSignal Help & Documentation

Welcome to the OneSignal New IA developer hub. You'll find comprehensive guides and documentation to help you start working with OneSignal New IA as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Discussions

Account Management

Adding, removing, deleting, renaming Apps and Organizations. Setting up Account Administrators.

Account management with OneSignal can be handled at the individual App or Organization level. Currently, only Organizations have 2 types of User Permissions (Administrators and Viewers). Apps only have Administrator permissions at this time.


Org-level vs App-level Admins

Org-level Admins will not have access to an app if they are not an App-level admin.

App-level Admins must add the Org-level Admin to the app for it to be included in the Organization.

PermissionApp-Level AdminOrg-Level AdminOrg-Level Viewer
Billing InformationNoYesNo
User permissionsNoYesNo
Add or Remove Users from Accessing your AccountYes (App-level only)YesNo
Add or Remove Apps within an OrganizationNoYesNo
Delete Subscribers, Apps, and AccountYesYesNo
Rename Apps and OrganizationsYes (App-level only)YesNo
Reset OneSignal PasswordYesYesYes
Access and reset REST API KeysYesYesNo
Send MessagesYesYesNo
Create SegmentsYesYesNo
Access App User and Notification DataYesYesYes (Read-only)

Accessing and Editing Billing Information

Pro Plans please contact [email protected] with your full Company Name and billing email if available.

Starter Plans can view and edit billing information under Organizations > Your Paid Organization Name > Billing

You can download all previous invoices from this page, upgrade to a Pro Account, downgrade to free account, update company name, company email contact and billing method.

Downgrading Paid Plans to Free

Select Options > Downgrade to Free and verify your Organization Name.

Starter Plans can downgrade to free anytime. See our Billing FAQ for more details.

Add, Remove, or Update User Access

App-Level Administrators can assign emails to have access on a per-app basis under Settings > Administrators. You will need to add Org-Level Admin emails to the app so they can add the App to an Organization.

Organization-Level Administrators can assign emails to have Administrator or Viewer Permissions within Organizations > Your Organization > Roles > Add Person

View Level User Permission are only available at the Organization Level on Paid Accounts. Free Accounts only get Administrator Level Permissions.

Users can be removed from an App or Org and User Permissions can be updated for an Org using the Options button next to the email.

Add or Remove Apps within an Organization

Add Apps to an Organization inside Orgs > Your Organization > Add Apps

You must have Org-Level and App-Level Access to add an App to the Organization. Contact your App Admins and ask them to follow this guide: Adding Administrators To Your App.

Remove Apps from an Organization inside Orgs > Your Organization > Options > Remove App From Organization

Deleting Apps, Subscribers and Accounts


Deletion is Permanent!

Once you delete data from OneSignal, it cannot be undone.

Delete Apps

You can delete Apps in the All Applications Page > Options > Remove. Make sure to Remove the app from the Organization before deleting.

Delete Users

To delete users, see our Delete Users Guide.

Delete Account

Deleting your account from OneSignal will only delete your specific email from our database. It will not delete Apps or downgrade your Paid Plan. Before deletion, make sure to do the following:

In the top-right of your OneSignal Dashboard, select the icon > Account & API Keys.

Scroll to the bottom and select "Delete Your Account"

Rename Apps and Organizations

Under Apps, next to the app, select Options > Rename.

Under Organizations, next to the Organization, select Options > Rename.

Reset OneSignal Account Password

In the top-right of your OneSignal Dashboard, select the icon > Account & API Keys.

Enter a new password, confirm the password and select Submit.


I am on the paid plan. Why am I still seeing limitation notices?

If you're already on a paid plan and are receiving account limitation notices, chances are your app/website isn't a part of your paid plan organization.

To remedy this, please follow the instructions to Add an App to your Organization

If you need assistance, please email [email protected] with your Organization ID and a list of App IDs you would like added to your Organization and we will process this for you.

I run an agency, what are my options?

OneSignal is setup to have an Organization that controls payments (like the Parent) and OneSignal Apps (children) that control the data from the site and/or mobile apps.

Since our pricing is based on total subscribers per app added to an Organization, you have 2 options:

  1. you can setup your account with us under your Organization to hold all your client's OneSignal apps and you handle payment.
  2. you or your clients can setup their own apps and organizations to pay us directly (if they need a paid account).

In either case, you can separate which apps need to be "free" and which ones need to be "paid" by simply adding the "paid" ones under the Organization.

If you need further clarification, please reach out to our sales team and tell us about your needs!

Updated 2 months ago

What's Next

User Roles

Account Management

Adding, removing, deleting, renaming Apps and Organizations. Setting up Account Administrators.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.