Filtering and mapping actions
Sign up for early access!
Apply for early access to be among the first to try out Customer.io Data Pipelines. Bear with us: it may take a few weeks for us to approve your request as we're actively working on CDP.
How it works
Each destination has a list of available actions. An action is how we map source data to your destination. In most cases, the defaults are all you’ll ever need.
But you might want to add additional action filters or change the values we map to various events to change when we send data to your destination or fine-tune the data that we send with each action.
You can toggle actions on and off and change data mappings in your destination’s Mappings tab.


API Calls to Actions
API calls come in from your sources. If they match the Trigger and Filter for your destination, we’ll perform an action that sends data to your destination.
destination trigger} b-->|yes|c(Map data to
destination) b-.->|no|d(Event is not
forwarded to destination)
Actions have a few properties.
- Action/Type: the type of action we’ll perform at the destination.
- Filter/Trigger: the criteria that source events must match to trigger the action
- Mappings: the data that we map from your source data to the destination.
Changing actions mappings
Again, you’ll generally want to use our default actions and mappings. But, when you set up a destination, you can go to the Mappings tab and enable or disable actions. You can also click to change the way we map values to actions.
When should I change filters/triggers?
Changing a filter determines when we send data to your destination. You might want to change a filter to limit when we send data to your destination.
For example, most destinations have an some kind of “Identify User” action that occurs whenever you pass an identify
call. If your destination relies on an email
trait, you might change the filter so that you only send identify
calls when the call contain an email
trait.


When should I change mappings?
You’ll want to change mappings when your source data doesn’t naturally map to your destination’s action. For example, you may want to add additional traitsInformation that you know about a person, captured from identify
events in Customer.io Data Pipelines (CDP). Traits are analogous to attributes in Customer.io Journeys. that you always capture in identify
calls from sources.
For example, if your destination expects a phone
number, and your source always captures an imei
trait, you may want to add a new mapping that sends traits.imei
to phone
.

