Events

An event is the central entity of the platform. Everything that happens in your operation — a transaction, an authentication, a logistics milestone — reaches the platform in the form of an event.

By modeling your occurrences as events, you gain a single, standardized entry point for data ingestion, regardless of the business domain. This allows you to:

  • analyze data in real time: track what is happening in your operation as events arrive;
  • create custom metrics: aggregate values, calculate rates, and track trends directly from received events;
  • configure monitors: define rules to detect anomalies, risks, or performance drops;
  • evolve without coupling: add new fields and event types without breaking existing integrations.
Event Type
type:     "transaction"
fields:
  amount:   number
  status:   string
  currency: string
schema
validates
Event
type:     "transaction"
id:       "evt_8f3a"
amount:   99.90
status:   "approved"
currency: "BRL"
occurrence

How events are organized

Each event belongs to an event type, which defines the expected data contract — which fields exist, their types, and whether they are required. These types can represent different business contexts, such as financial transactions (transaction), user authentication (user_authentication), and logistics delivery milestones (logistics_delivery_event).

You define event types according to the reality of your operation and send occurrences to the POST /events endpoint. The platform validates, processes, and makes the data available for analysis, metrics, and monitors.

Table of contents