Keys & IDs
Details on your OneSignal App Id, REST API Key, User Auth Key management and manually disabling your app.
Dashboard > Settings > Keys & Ids
This section contains details on the selected OneSignal App:
| Option | Parameter | Details |
|---|---|---|
| 1 | OneSignal App ID | Public Key used for initialization and app identification. |
| 2 | REST API key | Private key used for most API calls involved with sending push notifications and updating users. Details on how to Reset your REST API Key if you feel this key is compromised or made public. |
| Security 3 | Disable App | Stops messages from being sent but users can still subscribe to your app/site. You must remove the OneSignal code to stop subscription events. |
| 4 | User Auth Key | Another type of REST API key used for Account related updates. |
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.
Your App Auth Key, which is your REST API key for app-specific operations (getting users of an app, modifying users, getting notifications, sending notifications) listed in the Keys & IDs section, add an HTTP header with the key Authorization and the value Basic REST_API_KEY, where you should replace REST_API_KEY with your actual APP REST API key.
Resetting your REST API Key
Visit Settings -> Keys & IDs -> On the right side where tip text is displayed, click "reset your API Key".
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 which can be found in Account manages operations outside of an app (e.g. creating an app). Click on the account dropdown on the top right of your dashboard and scroll down to the User Auth Key section. It is past the section that displays each of your app's auth keys.
Your OneSignal user authentication key has been reset
If you reset your User Auth Key, you will receive an email letting you know this occurred.
If you didn't do this, login to onesignal.com to reset your Password which will update your User Auth Key. Also, you should Reset Your REST API keys in case they were compromised.
Updated almost 3 years ago