# Customer.io
URL: https://docs.awellhealth.com/docs/marketplace/customerio

> For the complete documentation index, see [llms.txt](https://docs.awellhealth.com/llms.txt).



<img src="/marketplace/customerio.svg" width="48" height="48" />

Customer.io is a customer engagement platform designed to create personalized customer journeys that engage, convert, and scale.

Category: Customer Support. Adds 1 action to a care flow.

## What to configure [#what-to-configure]

Set these once, on the extension in Awell Studio. An action fails at run time if a
required setting is missing.

| Setting | Required | Notes                                                                                   |
| ------- | -------- | --------------------------------------------------------------------------------------- |
| API Key | Yes      | The API key needed to authenticate requests to the Customer.io API. Stored as a secret. |
| Site ID | Yes      | This ID references the workspace you are working in.                                    |

## Actions [#actions]

Customer.io adds this action to a care flow. Add one to a step, then fill in its inputs.

### Track person event [#track-person-event]

Track a person event in Customer.io

| Input                  | Type     | Required | Description                                                                                                                          |
| ---------------------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Person identifier type | `string` | Yes      | The identifier type used to identify the person. Defaults to email. One of: id, email, cio\_id.                                      |
| Identifier value       | `string` | Yes      | The value of the identifier used to identify the person.                                                                             |
| Event name             | `string` | Yes      | The name of the event. This is how you'll find your event in Customer.io or select it when using events as campaign triggers.        |
| Attributes             | `json`   | No       | Additional information that you might want to reference in a message using liquid or use to set attributes on the identified person. |

Tracks an event for a person in Customer.io. You can identify a person using `email`, `cio_id` or `id`, give your event a name and optional attributes.

By default, Awell adds the following attributes to the event:

* `_awell_careflow_id`: The ID of the careflow.
* `_awell_careflow_definition_id`: The ID of the careflow definition.
* `_awell_patient_id`: The ID of the patient.
* `_awell_activity_id`: The ID of the activity.
* `_awell_identifier_{system_namespace}`: For every identifier the patient has in Awell, an attribute is added with the system namespace as the key and the identifier value as the value.

## Setup and notes [#setup-and-notes]

### Customer.io [#customerio]

Customer.io is a customer engagement platform designed to create personalized customer journeys that engage, convert, and scale.

### Settings and setup [#settings-and-setup]

To start using the Customer.io extension, you need to create an account and get your API key and site ID.

## Changelog [#changelog]

## Customer.io changelog [#customerio-changelog]

## Where this page comes from [#where-this-page-comes-from]

The settings, actions, inputs, outputs and webhooks above are generated from the
extension's own code, at `@awell-health/awell-extensions` v2.1.159. They match what the
platform actually does rather than a description of it.

Field-level detail also appears in Awell Studio when you configure the action.
Something wrong or missing? Email [support@awellhealth.com](mailto:support@awellhealth.com).