Skip to main content

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.
To send events to Customer.io through your webhook endpoint and your transformation code, use the Customer.io webhook connector.

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
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
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
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

Settings

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

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.
Last modified on November 20, 2026