Skip to content

POST /customers/{id}/events ​

Track an event for a person

DetailValue
Operation IDcustomers.trackEvent
MethodPOST
Path/customers/{id}/events
ConnectorCustomer.io Track API

Parameters ​

NameLocationTypeRequired
idpathstringYes

Request Body ​

FieldType
namestring
typestring
timestampinteger
dataobject

Using this endpoint in a workflow ​

  1. Add an API Call node to your workflow.
  2. Pick your Customer.io Track API connection from the Connection dropdown.
  3. In the Operation dropdown, select customers.trackEvent.
  4. 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.