> This page is part of the [Customer.io documentation](https://docs.customer.io). For the complete index, see [llms.txt](https://docs.customer.io/llms.txt).
> Last updated: September 1, 2026
> To take actions in Customer.io from an agent, use the [Customer.io CLI](https://docs.customer.io/ai/cli/get-started.md) or the [MCP server](https://docs.customer.io/ai/mcp/get-started.md).

# Understanding semantic events

Many of the actions for outbound integrations are based on the `name` of the event you send. With these *semantic events*, we expect a certain set of properties that we use to map to multiple integration destinations.

While you can send any properties and events that you want, taking advantage of our pre-defined semantic events can save you time and effort, helping you take advantage of our default actions—so it’s easier to set up data-out integrations.

We have sets of standard semantic events for the following purposes:

*   [Customer.io](/integrations/data-in/semantic-events/cio-journeys/)
*   Mobile
*   [A/B Testing](/integrations/data-in/semantic-events/a-b-test/)
*   [Ecommerce](/integrations/data-in/semantic-events/ecommerce/)
*   [Email](/integrations/data-in/semantic-events/email/)
*   [Live Chat](/integrations/data-in/semantic-events/live-chat/)
*   [Video](/integrations/data-in/semantic-events/video/)

## Semantic Properties

Within these events, we also have *semantic properties*—properties that we expect to see in certain events. These properties are also mapped to our data-out integrations, so you can get up and running quickly.

For example, the `product_viewed` event in our ecommerce specification typically contains `product_id` and `brand` properties, so you know which product profiles viewed and the brand of that product.

©2026 Peaberry Software, Inc. [Status](https://status.customerio.com/) [Terms of Service](https://customer.io/legal/terms-of-service/) [Privacy Policy](https://customer.io/legal/privacy-policy/)

[](https://www.linkedin.com/company/customer-io)[](https://twitter.com/customerio)[](https://www.youtube.com/channel/UCkCaWdezRoa8ZyR9pEVaipA)[](https://www.instagram.com/customer.io/)