- Integrations
- /
- Customer.io
- /
- Actions
- /
- Track Custom Event
ActionCustomer.ioUpdated May 2026
How do I push a custom event to Customer.io?
Short answer: Drop the "Customer.io → Track Custom Event" action anywhere in your workflow, map the inputs from upstream nodes, and publish.
Inputs
The fields this action accepts.
Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.
| Field | Type | Required | Description |
|---|---|---|---|
Customer Identifier identifier | string | Required | Customer Identifier. e.g. "user@example.com" |
Event Name name | string | Required | Event Name. Example: purchase_completed |
Event Data (JSON) data | string | Optional | Custom data attached to the event |
Sample request
{"identifier": "user@example.com","name": "e.g. purchase_completed","data": "{\"product\": \"Pro Plan\", \"amount\": 99}"}
Returns
{"success": true}
Use these fields in downstream nodes for routing, logging, or error handling.
Triggered by
Apps that pair well as the trigger for Track Custom Event.
Any of these apps can fire this action as part of a workflow.
FAQ
Questions about Track Custom Event.
What does the Track Custom Event action do in Customer.io?
Pushes a behavioural event into Customer.io's event store. Journeys and campaigns can trigger on these. The standard hook for "server-side action happened → fire CIO event to start the matching journey".
What inputs does Track Custom Event require?
Required: Customer Identifier, Event Name. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Customer.io returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does Track Custom Event support batch operations?
Yes. Run Track Custom Event inside a Loop node to process arrays. Tiny Command handles Customer.io's rate limits automatically so you don't have to throttle manually.
More actions
Other Customer.io actions.
Action
Delete Person
Hard-deletes the person and history. Irreversible — used for GDPR right-to-erasure compliance flows. For soft-removal use suppression list or unsubscribe.
ActionIdentify Person
Upserts person-level attributes (plan, country, signup_date, lifetime_value). The state update that drives segmentation and journey targeting. For "external state change → reflect in CIO for accurate audience filtering" sync.
ActionSend Transactional Email
Fires a transactional template (designed in Customer.io UI) at a specific recipient with merge data. For "password reset, order confirmation, receipt" workflows where the email content is reviewed in CIO but the trigger is external.
Send track custom event from your workflows.
Triggered by anything in the catalog. Free tier available. No credit card.