POST /customers/{id}/events ​
Track an event for a person
| Detail | Value |
|---|---|
| Operation ID | customers.trackEvent |
| Method | POST |
| Path | /customers/{id}/events |
| Connector | Customer.io Track API |
Parameters ​
| Name | Location | Type | Required |
|---|---|---|---|
id | path | string | Yes |
Request Body ​
| Field | Type |
|---|---|
name | string |
type | string |
timestamp | integer |
data | object |
Using this endpoint in a workflow ​
- Add an API Call node to your workflow.
- Pick your Customer.io Track API connection from the Connection dropdown.
- In the Operation dropdown, select
customers.trackEvent. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
Required fields are marked — fill them or the call will fail at runtime.
What it returns ​
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Customer.io Track API API reference.