# OneSignal

## **Setup**

1. Go to: `Settings → 3rd Party Sources → Cohort Export`
2. Click the ✎ icon next to **OneSignal**
3. Fill in the fields:
   * **App ID** – available in your app settings in the [OneSignal](https://onesignal.com/) dashboard (`Settings → Keys & IDs → OneSignal App ID`)
   * **REST API Key** – also found under `Settings → Keys & IDs → API Key`
4. Click `Save` to apply.

<figure><img src="https://2105883905-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnGcP_ZeRJ1ipj9O8dF%2Fuploads%2F1ADI8XOiA3PSCSF6S81o%2FScreenshot%202025-07-23%20at%2014.14.54.png?alt=media&#x26;token=e0bb0e4b-5e48-4d0e-ab8c-86b8c0ea3127" alt=""><figcaption></figcaption></figure>

*To disable the integration, turn off the toggle.*

### **User Identifier**

* Set a [custom property](https://docs.devtodev.com/integration/integration-of-sdk-v2/setting-up-events/user-profile#custom-user-property) in devtodev: `onesignal_id`. This identifier ensures accurate tracking and segmentation of users during data export.&#x20;
* `onesignal_id` must match the **External ID** you set when identifying users in OneSignal, [see OneSignal documentation](https://documentation.onesignal.com/docs/users#external-id).
* Make sure this property is set before cohort export.

## How to prepare cohorts

Check out the **Tuning section** to learn [how to export the cohorts](https://docs.devtodev.com/reports-and-functionality/project-related-reports-and-fuctionality/tuning#cohort-export).&#x20;