Dub Destination Setup Guide Beta

Set up Dub as a destination in RudderStack.

3 minute read

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 Information
Status: Beta Supported sources: Android (Java) , Android (Kotlin) , iOS (Obj-C) , iOS (Swift) , Web, Unity, AMP , Cloud, React Native , Flutter, Cordova, Shopify Refer to it as Dub in the Integrations object.

Connection Modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android (Java)
Android (Kotlin)
Cloud
Cordova
Flutter
iOS (Obj-C)
iOS (Swift)
React Native
Shopify
Unity
Web

Supported Message Types
Source	Identify	Page	Track	Screen	Group	Alias	Record	AudienceList
Cloud mode
Supported sources

Setup

In your RudderStack dashboard, set up a source.
Go to the Overview tab of your source and select Add Destination > Create new destination.

Add new destination in RudderStack dashboard

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

Connection settings

Setting	Description
Name	Assign a name to uniquely identify the destination in RudderStack.
API key Required	Your Dub API key used for authentication. It must follow the format `dub_` followed by alphanumeric characters. Note that: Your Dub API key must have the relevant permissions to create conversion events. Make sure to secure your API key — anyone with access to this key can send conversion events to your Dub account.
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. If this setting is disabled, RudderStack sends the specified amount value as is, without any conversion. See the Dub documentation for more information on currency conversion support.

Configuration settings

Setting	Description
Event mappings	Map your RudderStack events to Dub’s `LEAD_CONVERSION` or `SALES_CONVERSION` events. To successfully deliver events to Dub, you must: Configure the event mappings via this setting Include the `clickId` parameter in those events. See the Cloud Mode Integration guide for detailed mapping instructions.
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 for more information on this feature. When consent management is enabled, RudderStack only sends events to Dub when the user has provided appropriate consent.

Next steps

After setting up your Dub destination in RudderStack:

See the Dub Cloud Mode Integration 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 guide for answers to the commonly asked questions on this integration

FAQ

Where can I find my Dub API key?

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

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