> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer.io App

> Install the official Customer.io app to add Dodo Payments customers to Customer.io as people and send payment, subscription, refund, and dispute events. The app sends no message.

## What the Customer.io app does

The Customer.io app adds a customer to Customer.io as a person after a successful payment and when a subscription starts or renews. It also sends Dodo Payments events, for example `dodo_payment_succeeded`. The app sends no message.

> [!NOTE]
>
> To send events to Customer.io through your webhook endpoint and your transformation code, use the [Customer.io webhook connector](https://docs.dodopayments.com/integrations/customer-io.md).

## Before you start

* You are an owner or an admin of the Dodo Payments business.
* You have a Customer.io workspace, its Site ID, and its Track API key.
* You know if your workspace is in the US or in the EU.

## Install, connect, and configure

**1. Install the app**

Open **Apps**, then **Explore**. Open **Customer.io** (publisher **Dodo Payments**) and select **Install app**.

![The Installed tab of Apps with Customer.io in the list and the status Active](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/customer-io-4.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=dcb27173179f5ace644a0c400e9ec0cc)

**2. Connect Customer.io**

Select **Connect**. In Customer.io, open **Workspace Settings**, then **API and webhook credentials**. Copy the Site ID and the Track API key. In the dialog, select the **Region**: `track` for the US, or `track-eu` for the EU. Enter the Site ID and the Track API key, then select **Connect**.

![The Connect Customer.io dialog with the Region, Site ID, and Track API key fields](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/customer-io-3.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=eb792f8812086537e339c2b523de42b5)

The app uses the Site ID and the Track API key. It does not support a private key that starts with `sk_`.

**3. Choose the settings**

Open the **Configure** tab, set the options, and select **Save**.

![The Configure tab of the Customer.io app with the setting switches and the Customer.io identifier list](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/customer-io-1.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=ae057d31ebd043b93d6399b6be04c686)

**4. Pick the filters**

Pick the products and currencies, then select **Save**.

![The Customer.io Configure tab with the Customer.io identifier, Products, and Currencies filters](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/customer-io-2.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=acd9c38648a238c59be25f78eb8b60a2)

## Settings

| Setting | What it does | Default |
| - | - | - |
| Add customers as people | Add or update a person for each successful payment and each new or renewed subscription. The app writes the attributes `email`, `name`, `dodo_customer_id`, and, for a subscription, `dodo_subscription_status`. | On |
| Write the subscription status | Write `on_hold`, `cancelled`, or `expired` to the attribute `dodo_subscription_status` of an existing person. This setting creates no person. | On |
| Send events | Send payments, subscription changes, refunds, and disputes as Customer.io events. | On |
| Customer.io identifier | The customer value that identifies the person: **Customer email** or **Dodo customer ID**. Use the Dodo customer ID only in a workspace that identifies people by ID. The app then sends the email as an attribute. | Customer email |
| Products | Send data only for the products that you pick. The filter applies to the customers and to the events. | All |
| Currencies | Send data only for the currencies that you pick. | All |

## What is sent and when

Dodo Payments sends data after the Dodo Payments event happens. The app sends the email address, the name, and the Dodo customer ID of the customer. It also sends the subscription status and its time. An event also sends the object IDs, the status, the product IDs, the currency code, the amount, and the mode. The app sends no card data and no address.

Customer.io ignores a repeat of the same event. When **Send events** is on, an event can add a person that does not exist.

The app updates the name of an existing person at each payment. A name that you changed in Customer.io changes back to the name in Dodo Payments. The status time has a resolution of one second. Two status changes in the same second can arrive in a different order.

## Test the app

**1. Use test mode**

Install and connect the app in test mode.

**2. Make a test payment**

Create a test payment with a test customer email.

**3. Check Customer.io**

Open **People** in Customer.io. The test customer appears. If **Send events** is on, the event `dodo_payment_succeeded` appears in the activity of the person.

## Troubleshooting

| Problem | What to do |
| - | - |
| The connection fails | Check the **Region**. Use `track` for the US and `track-eu` for the EU. Copy the Site ID and the Track API key again. |
| The key starts with `sk_` | The app does not support this key. Use the Track API key. |
| The status of the subscription is in the wrong order | Two status changes in the same second can arrive in a different order. |
| People appear with a different identifier | Check the **Customer.io identifier** setting. Use the Dodo customer ID only if your workspace identifies people by ID. |
| **Connection needs attention** | Customer.io stopped accepting the credentials. Select **Reconnect** and enter new credentials. |
| No data arrives | Check that the setting switch is on and that the product and currency filters do not skip the event. Check that the customer has an email address. |

## Disconnect and uninstall

Turn off the settings on the **Configure** tab to stop sending data. Uninstall the app to delete the Customer.io connection. See [Manage and uninstall](https://docs.dodopayments.com/features/app-marketplace/manage-and-uninstall.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.