Events
An event is a named thing a contact did, with optional properties and a timestamp. Send them from the browser (public key) or your backend (secret key), see track.
{ "contactId": "user-123", "event": "project_created", "properties": { "template": "blank" } }Event definitions
Workflows → Event definitions documents each event name: what it means, which category it belongs to, and the properties it carries. Definitions are grouped by category, which is only for finding them. A workspace starts with no definitions: add standard events from Templates, or define your own. Names that arrive undefined appear as Undefined until you describe them. Defining an event before sending it lets editors suggest it, but any name is accepted.
Timestamps and backfilling
Events default to the time they arrive. A secret key may set timestamp to record when the event actually happened, use this to backfill history when you first install JourneyKit. Public keys cannot set timestamps (a browser shouldn't be able to rewrite the past).