Define a custom event

Define a custom event with typed properties.

You'll create a custom event that captures a specific user action in your product, then validate incoming data against a schema you define. Custom events let you track exactly what matters to your business — from sign-ups to feature usage — with confidence that the data arriving is clean and complete.

1

Open Events in the sidebar.

Open Events in the sidebar.

Events are the building blocks of your analytics — each one represents a distinct action you want to measure.

2

Click New event.

Click New event.

 

3

Set the Event name in snake_case; the SDK call sends this value, so keep it stable after shipping.

Name the event in snake_case — the name is what your SDK call sends, so keep it stable once shipped.

 

The event name becomes the identifier your SDK sends, so choose something descriptive and keep it consistent once you ship code that references it.

 

4

Click Save event; the schema validates incoming properties and flags unexpected ones.

Click Save event — the schema validates incoming properties and flags anything unexpected.

 

The schema now protects your data pipeline: any property that doesn't match your definition is caught and flagged before it reaches your analytics.

 

What's next

With your event defined and validated, add typed properties to capture the details that matter — like user ID, feature name, or conversion value.