Add a destination
How it works
A destination is the place you want to send your data to—where you store data, use it to gather analytics, to power marketing automation (like Customer.io Journeys), and so on.
You can send data from any number of sources into a destination, or you can do simple one-to-one mapping—whatever you need. However, in most cases, you’ll find that you typically want to aggregate data from multiple sources to a single destination—so you can act on a holistic understanding of your audience.
Set up a Destination
This is a very generic process. The steps involved in configuring your destination will change based on the specific destination and mode you enable. See an individual destination connection to learn more about the individual steps, and the information you’ll need, to connect a destination.
- Go to the Data Pipelines tab and click Connections.
- Click Add New under Destinations.
- Select the Destination you want.
- Configure your destination and click Continue.
- Select the subscriptions—the events that you want to send to the destination. See Subscriptions below for more information.
You can change field mappings
In most cases, you’ll want to use default mappings with your destination. But, if you have a specialized use case and want to change the way we map fields to your destination’s events, you can click next to an event. See event mapping below for more information.
- (Optional) Select the sources that you want to connect to this destination. You can always connect sources to your destination later. You may not want to map sources to your destination
- Click Enable Destination.
Authenticating with a destination
When you add a destination, you need to provide us with a credentials to authenticate with your destination. Most destinations use an API token or authentication code that you can get from their web app. If you can’t get credentials from the service you want to connect to Customer.io, you won’t be able to finish setting up your destination.
The documentation for each destination includes information about what you need, and how to find it.
Why can’t I connect my destination to a particular source?
You might have tried to connect a direct-mode destination to a server-based source. Unfortunately, that kind of connection won’t work.
Where we can update our client-side JavaScript source automatically when you add new direct-mode destinations, we can’t do the same with our server libraries. Our server libraries run in your app/server and aren’t aware of your destinations, therefore they can’t send data directly to your destinations. Our server libraries only support cloud-mode destinations.
Do I need to update sources when I add a destination?
No. You don’t need to update anything.
If you use our JavaScript source library in your website, it’ll automatically handle associated configuration changes when you connect it to a destination. Source data comes into Customer.io and we’ll automatically route it to your destinations.
While we’ll always capture source information from our JavaScript source and server libraries, you’ll only see the traffic we send to your destination if your destination is in cloud mode. If your destination is in direct-mode, we will not show the events that we send to your destination.
