# Crear evento

`POST` `/events`

Registra un nuevo evento

## Cuerpo de la solicitud

- **event** (`object`, required)
  - **timestamp** (`date-time | null`) — Fecha y hora en que se generó el evento en formato [ISO 8601](https://es.wikipedia.org/wiki/ISO_8601). Si no se envía, se usará la hora actual. El plazo máximo para envío retroactivo (backfill) es de 24 horas. No se permiten horarios futuros.
  - **id** (`string`, required) — Código identificador único de la entidad. Reutilice el mismo código para enviar eventos diferentes en la misma entidad.
  - **type** (`string`, required) — ID del tipo del evento
  - **attributes** (`object`, required) — Datos del evento de acuerdo con los campos configurados.
  - **rule** (`object | null`) — Indique, opcionalmente, la regla que se aplicará.
    - **name** (`string | null`) — Nombre de la regla, según su registro previo. Si la regla indicada no existe, no tiene una versión activa publicada o no pertenece a este tipo de evento, la solicitud no fallará y no se ejecutará ninguna regla.

```json
{
  "event": {
    "timestamp": "2024-01-01T00:00:00Z",
    "id": "string",
    "type": "transaction",
    "attributes": {
      "amount": "120.50",
      "status": "paid"
    },
    "rule": {
      "name": "minha_regra"
    }
  }
}
```

## Respuestas

### 201 — Evento creado con éxito

### 401 — Credenciales de acceso inválidas

- **errors** (`array`)
  - **field** (`string`) — Campo de la solicitud donde ocurrió el error
  - **type** (`string`) — Código del tipo del error
  - **message** (`string`) — Mensaje del error

```json
{
  "errors": [
    {
      "field": "string",
      "type": "string",
      "message": "string"
    }
  ]
}
```

### 422 — Parámetros inválidos

- **errors** (`array`)
  - **field** (`string`) — Campo de la solicitud donde ocurrió el error
  - **type** (`string`) — Código del tipo del error
  - **message** (`string`) — Mensaje del error

```json
{
  "errors": [
    {
      "field": "string",
      "type": "string",
      "message": "string"
    }
  ]
}
```