# Setup Guide

This guide will help you set up OneSignal as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to OneSignal.

## Connection compatibility

{{< destination-config >}}

## Setup

1. In your [RudderStack dashboard](https://app.rudderstack.com/), add a source. Then, from the list of destinations, select **OneSignal**.
2. Assign a name to the destination and click **Continue**.

### Connection settings

| Setting | Description |
| :----| :-----|
| App ID | Enter your [OneSignal App ID](#where-can-i-find-the-onesignal-app-id). |
| Event version to use | Select the OneSignal API to use. RudderStack provides the following options:<br /><br /><ul><li>Device Model (Deprecated)</li><li>User Model (Recommended)</li></ul> See the [OneSignal documentation](https://documentation.onesignal.com/docs/user-model-migration-guide) for more information. |
| Toggle on to add a device/subscription using email | Turn on this setting to add a new device to your OneSignal app using the email. |
| Toggle on to add a device/subscription using phone number | Toggle on this setting to add a new device to your OneSignal app using the phone number.  |
| Toggle on to concatenate event name with properties | Turn on this setting to concatenate the event names with properties. <br /><br />For example, if `add_to_cart` is an event and `brand` is a property, the event will be sent as `add_to_cart_brand` tag. |
| Allowed Property List | Enter the properties you want to add as device [tags](https://documentation.onesignal.com/docs/add-user-data-tags), if present in the payload. <br /><br />**Note**:  RudderStack considers the properties mentioned under this setting only for the `track` and `group` calls. |
| Consent management settings | Configure the consent management settings for the specified source by choosing the **Consent management provider** from the dropdown and entering the relevant consent category IDs. See [Consent Management in RudderStack]({{< ref "data-governance/consent-management/overview.md" >}}) for more information on this feature. |

## Next steps

- [Send events via User Model API]({{< ref "destinations/streaming-destinations/onesignal/user-model.md" >}})
- [Send events via Device Model API (Deprecated)]({{< ref "destinations/streaming-destinations/onesignal/device-model.md" >}})

## FAQ 

#### Where can I find the OneSignal App ID?


1. Log in to your [OneSignal dashboard](https://dashboard.onesignal.com/).
2. Go to your app's **Settings** > **Keys & IDs**.
3. You will find the OneSignal App ID:

{{< image src="images/event-stream-destinations/onesignal-app-id.webp" alt="OneSignal license code and API key" >}}