Keys & IDs
Details on your OneSignal App Id, REST API Key, User Auth Key management, and manually disabling your app.
Settings > Keys & IDs
This section contains details on the selected OneSignal App.
![](https://files.readme.io/0db3877-Screenshot_2024-03-11_at_2.03.01_PM.png)
App ID
Your OneSignal App ID (or just App ID) is the main identifier we use to differentiate your app from all other OneSignal apps. You will use this in all your SDK initialization codes and API calls. The App ID should not be treated as private.
REST API Key
Do not share this key
Treat your REST API Key as though it is a password - do not add it to your app code or public repositories (e.g. github) and do not share it with anyone.
The App Auth Key serves as the API Key to our REST APIs. You can find this key on your app's Keys & IDs page in the OneSignal Dashboard. Include this key in the Authorization
header using the Basic Authentication scheme e.g., Basic REST_API_KEY
.
Resetting your REST API Key
Visit Settings > Keys & IDs and click Generate New API Key to destroy the current REST API key and generate a new one.
Disabling Your App
You may disable your app to prevent new and scheduled notifications from being delivered.
You will still receive new subscribers if you disable the app. You must remove or comment out the OneSignal code to stop new subscriptions.
Apps you manually disable can be instantly re-enabled at any time.
User Auth Key
Your User Auth Key is for app management API requests (e.g. using the Creating an app and Viewing apps) and is unique to each user.
Click your icon > Account & API Keys >
![](https://files.readme.io/22ce468-Screenshot_2024-06-05_at_5.30.19_PM.png)
Generate New User Auth Key
You need to generate your user Auth Key each time to access it. If you reset your user Auth Key, you will receive an email letting you know this occurred.
Updated 3 months ago