# Connect OneSignal account

### How to connect your OneSignal account with your app?

Connect their own OneSignal account to gain better control over push notifications. This allows you to manage and send notifications directly from your own OneSignal dashboard.

{% hint style="warning" %}
Connecting your own OneSignal account is available only on the Premium plan.
{% endhint %}

{% embed url="<https://scribehow.com/viewer/Connect_OneSignal_account__aXg_Wk1yR42RddV50_I5vw>" %}

#### Step 1: Enable OneSignal authentication

* Go to [Notifications > Advanced Notification](https://app.appmysite.com/app/advanced-notifications) from your app dashboard.
* Open the [One Signal configuration screen](https://app.appmysite.com/app/advanced-notifications/authentication).&#x20;
* Locate Use my own OneSignal account.
* Turn the toggle On.

{% hint style="success" %}
Once enabled, you will be able to enter your OneSignal credentials.
{% endhint %}

#### Step 2: Get your OneSignal credentials

* Log in to your OneSignal account.
* From the side menu, open Organization.
* Under Organization, go to Keys & IDs from the side menu.
* Copy the Organization ID shown under the OneSignal Organization ID section.
* Go back to your app dashboard and paste it into the OneSignal Organization ID field.
* Click the Add key button.
* In the pop-up, enter a name for the key.
* Generate the key and copy it.
* Return to your app dashboard and paste the copied key into the OneSignal Organization API Key field.

{% hint style="danger" %}
The Organization API Key is displayed only once when created. Make sure to copy and store it securely.
{% endhint %}

#### Step 3: Save and verify setup

* Click Save.
* Click Verify to authenticate your OneSignal account.

If successful, the status will display as Connected. If verification fails, you may see the message:

{% hint style="danger" %}
“Unable to verify OneSignal account. The provided credentials may be incorrect or the account may be temporarily unavailable.”
{% endhint %}

In this case, recheck your credentials and verify again.

#### Change or disable OneSignal configuration

By default, your app uses the AppMySite OneSignal account.

If you switch between the default AppMySite OneSignal account and your own OneSignal account, the following will occur:

* When switching from AppMySite OneSignal to your own OneSignal account
  * All previously scheduled notifications will automatically move to Draft.
  * Existing segments may no longer apply.
  * You may need to recreate segments in your own OneSignal account.
* When switching back to the AppMySite OneSignal account
  * Notifications created under your own OneSignal account will remain in Draft.
  * Segments associated with the AppMySite OneSignal account will become available again.

A confirmation pop-up will appear before changing this setting.

{% hint style="warning" %}
After changing the OneSignal configuration, you will need to rebuild and republish your app for the changes to take effect.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.appmysite.com/app/notifications/advanced-notifications/connect-onesignal-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.