# Dub Destination Setup Guide


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

## Connection compatibility

{{< destination-config >}}

## Setup

1. In your [RudderStack dashboard](https://app.rudderstack.com/), set up a source.
2. Go to the **Overview** tab of your source and select **Add Destination** > **Create new destination**.

{{< image src="images/event-stream-destinations/add-new-destination.webp" alt="Add new destination in RudderStack dashboard" >}}

3. Select **Dub** from the list of destinations. Then, click **Continue**.

## Connection settings

| Setting | <div style="width:300px">Description</div> |
| :----| :-----|
| Name | Assign a name to uniquely identify the destination in RudderStack. |
| API key <br/> <span style="color: #4D4DFF;font-size:12px;">Required</span> | Your [Dub API key](#faq) used for authentication. It must follow the format `dub_` followed by alphanumeric characters. <br /><br />{{< warning >}}Note that: <br /><br /><ul><li>Your Dub API key must have the relevant permissions to create conversion events.</li><li>Make sure to secure your API key — anyone with access to this key can send conversion events to your Dub account.</li></ul>{{< /warning >}} |
| Convert amount to cents | This setting is toggled on by default. When enabled, RudderStack multiplies monetary amounts by 100 before sending them to Dub, thereby converting dollars to cents as required by Dub's API. <br /><br />If this setting is disabled, RudderStack sends the specified amount value as is, without any conversion. <br /><br />See the [Dub documentation](https://dub.co/docs/conversions/sales/introduction?dub_id=CTUiZfhX4cU7BsBJ#currency-conversion-support) for more information on currency conversion support. |

## Configuration settings

| Setting | <div style="width:300px">Description</div>  |
| :----| :-----|
| Event mappings | Map your RudderStack events to Dub's `LEAD_CONVERSION` or `SALES_CONVERSION` events. <br /><br />{{< warning >}}To successfully deliver events to Dub, you must: <br /><br /><ul><li>Configure the event mappings via this setting</li><li>Include the `clickId` parameter in those events.</li></ul>See the [Cloud Mode Integration]({{< ref "destinations/streaming-destinations/dub/cloud-mode.md" >}}) guide for detailed mapping instructions.{{< /warning >}} |
| 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. <br /><br />See [Consent Management in RudderStack]({{< ref "data-governance/consent-management/overview.md" >}}) for more information on this feature. <br /><br />{{< info >}}When consent management is enabled, RudderStack only sends events to Dub when the user has provided appropriate consent.{{< /info >}} |

## Next steps

After setting up your Dub destination in RudderStack:

- See the [Dub Cloud Mode Integration]({{< ref "destinations/streaming-destinations/dub/cloud-mode.md" >}}) guide to understand how RudderStack maps and sends events to Dub
- Send test events to verify your setup is working correctly
- See the detailed [FAQ]({{< ref "destinations/streaming-destinations/dub/faq.md" >}}) guide for answers to the commonly asked questions on this integration

## FAQ

#### Where can I find my Dub API key?

1. Log in to your Dub dashboard.
2. Click the profile in the left sidebar to see **Settings**.

{{< image src="images/event-stream-destinations/dub-api-key-2.webp" alt="Dub API Key Links" >}}

3. Go to the **API Keys** section and copy your API key — it should start with `dub_` followed by alphanumeric characters.

{{< image src="images/event-stream-destinations/dub-api-key-3.webp" alt="Dub API Key Links" >}}

<br />