# Events

Record customer moments that can trigger journeys and enrich contact history.

10 operations in the Events resource group.

## Operations

- [List event types](/reference/events/get-event-types.md) - GET `/event-types` - Returns predefined and custom event types that can be recorded against contacts.
- [Create event type](/reference/events/create-event-type.md) - POST `/event-types` - Creates a custom event type with an optional JSON Schema for payload validation.
- [Get event type](/reference/events/get-event-type.md) - GET `/event-types/{id}`
- [Update event type](/reference/events/update-event-type.md) - PATCH `/event-types/{id}` - Updates an event type. Schema changes must be backward-compatible with stored events.
- [Delete event type](/reference/events/delete-event-type.md) - DELETE `/event-types/{id}` - Deletes a custom event type when it is not predefined and has no recorded events.
- [List events](/reference/events/get-events.md) - GET `/events` - Returns recorded customer events, optionally filtered by event type.
- [Create event](/reference/events/create-event.md) - POST `/events` - Records an event against a contact. Prefer `POST /contacts/{contactId}/events` for new integrations.
- [Get event](/reference/events/get-event.md) - GET `/events/{id}` - Returns one recorded customer event.
- [List events by contact](/reference/events/get-events-by-contact.md) - GET `/contacts/{contactId}/events` - Returns the timeline of events recorded for a contact.
- [Create event for contact](/reference/events/create-contact-event.md) - POST `/contacts/{contactId}/events` - Records a customer moment such as a purchase, signup, or plan change. Matching active
journeys can react to the event after it is accepted.

## Schemas

- [ProblemDetails](/reference/schemas/problem-details.md) - object - RFC 9457 Problem Details response with a stable Flownally error code.
- [FieldViolation](/reference/schemas/field-violation.md) - object
- [Window](/reference/schemas/messaging-window.md) - object - Tells a client whether the current actor can send in this conversation right now.
- [EventTypesResponse](/reference/schemas/event-types-response.md) - object - Event type catalog.
- [EventType](/reference/schemas/event-type.md) - object - Event definition used to validate and classify recorded customer moments.
- [CreateEventTypeRequest](/reference/schemas/create-event-type-request.md) - object - Event type to add to the workspace catalog.
- [UpdateEventTypeRequest](/reference/schemas/update-event-type-request.md) - object
- [Response](/reference/schemas/events-response.md) - object - Paginated recorded events.
- [Event](/reference/schemas/event.md) - object - Customer event stored on a contact timeline.
- [CreateEventRequest](/reference/schemas/create-event-request.md) - object - Deprecated event creation body that includes contact ID in the payload.
- [CreateContactEventRequest](/reference/schemas/create-contact-event-request.md) - object - Event to record for the contact in the path.