# Events

Welcome to the Events API Documentation for Annex Cloud.

## Captures a single event with associated user details, event attributes, and system metadata.

 - [POST /event](https://annexcloud.redocly.app/loyalty/loyalty/events/postevents.md): To record an event in the system, use the POST method in the Events API. The request must include the event type, user information (such as identifiers), event attributes, and metadata. All other additional fields in the request and response body are listed below.

## Creates a new event with a defined schema

 - [POST /api/3.0/journeys/events](https://annexcloud.redocly.app/loyalty/loyalty/events/paths/~1api~13.0~1journeys~1events/post.md): Use this endpoint to create and configure a new event within the system. The request body must define the event's name, schema, and related configuration details. Once created, the event can be tracked, associated with users, and leveraged for reporting, segmentation, and journey workflows. Authentication and valid site details are required to access this resource.

## Retrieves the list of events configured in the system

 - [GET /api/3.0/journeys/events](https://annexcloud.redocly.app/loyalty/loyalty/events/getevents.md): Use this endpoint to fetch all events that are configured within the system. The response provides details of the available events and supports pagination to manage large result sets. Authentication and valid site details are required to access this resource.

## Deletes an event by its unique identifier

 - [DELETE /api/3.0/journeys/events/{event_id}](https://annexcloud.redocly.app/loyalty/loyalty/events/deleteevent.md): Use this endpoint to permanently remove an event from the system by specifying its unique event ID in the request path. Once deleted, the event and its schema definition will no longer be available for tracking or reporting. Authentication and valid site details are required to perform this action.