# Create event

**POST** `/events`

Records an event against a contact. Prefer `POST /contacts/{contactId}/events` for new integrations.

Authentication: bearerAuth
Required scopes: `event:create`
Allowed roles: `owner`, `admin`, `agent`
Authorization: Create an event in the workspace.

## Request body

- `application/json`: `CreateEventRequest` required.

## Responses

- `201`: Event created
- `409`: Event with this idempotency key already exists
- `default`: Error