# Cordial Destination

## About this integration

Cordial is a comprehensive marketing platform that helps businesses collect, normalize, and activate real-time data from anywhere within their technology stack. With this information, businesses can create and deliver tailored messages that flex and adapt to changing customer signals, improving engagement and satisfaction. This destination utilizes source data to add contacts and track cart activity, so you can message people with relevant data to maximize customer engagement and drive growth.

[Mode How we forward source data to the destination: through Customer.io's servers or directly from our JavaScript client.](/cdp/destinations/getting-started/#connection-mode)

[Web sources Indicates whether or not this integration supports our the JavaScript client.](/cdp/sources/getting-started/#types-of-sources)

[API sources Indicates whether or not this integration supports our server libraries (Go, NodeJS, Python), API, Mobile SDK, and other data sources.](/cdp/sources/getting-started/#types-of-sources)

[Supported calls The API methods this integration supports.](/cdp/sources/source-spec/source-events/)

[Integration name The name of this integration if you want to enable or disable it in the `integrations` object.](/cdp/sources/source-spec/common-fields/#the-integrations-object)

Standard

[track](/api/cdp/#operation/track), [identify](/api/cdp/#operation/identify), [group](/api/cdp/#operation/group), and [alias](/api/cdp/#operation/alias)

Cordial (Actions)

## Getting started[](#getting-started)

1.  Go to **[Data & Integrations > Integrations](https://fly.customer.io/workspaces/last/journeys/integrations/all/directory)** and select the **Cordial** entry in the *Directory* tab.
    
2.  (Optional) Select the data sources that you want to connect to your outbound integration. You can always connect data sources later. We’ll only show you data sources that work with your integration.
    
3.  Configure your integration.
    
    1.  **Api Key**: Your Cordial API Key
        
    2.  **Endpoint**: Cordial API endpoint. Leave default, unless you've been provided with another one. [See more details](https://support.cordial.com/hc/en-us/sections/200553578-REST-API-Introduction-and-Overview)
        
    3.  **Segment Id Key**: Cordial string unique attribute key to store Segment User ID in (e.g. `segment_id`)
        
4.  Click **Enable Destination**.
    

## Actions[](#actions)

When you’re done setting things up, you can go to the *Actions* tab to see how we map incoming data to your integration.

You may need to add actions for this integration

While we often have default triggers for actions, we don't always add those actions as defaults. You may need to add actions to make sure that you're sending all the data that you want to send to your integration. See our [actions](/integrations/data-out/actions/) page for help setting up actions.

Action

Default Trigger

Description

Create Contactactivity

`type = “track”` or  
`type = “page”`

Create a new contact activity.

Upsert Contact

`type = “identify”`

Create or update a contact in Cordial.

Add Contact to List

`type = “group”`

Add contact to a list. If the list does not exist in Cordial it will be created.

Remove Contact from List

Remove Contact from Cordial List

Add Product to Cart

`type = “track”` and  
`event = “Product Added”`

Add product to Cordial contact cart

Remove Product from Cart

`type = “track”` and  
`event = “Product Removed”`

Removes product from Cordial contact cart

Upsert Order

`event = “Order Completed”` or  
`event = “Order Updated”` or  
`event = “Order Refunded”` or  
`event = “Order Cancelled”`

Upserts order to Cordial

Merge Contacts

`type = “alias”`

Merge contacts in Cordial.