# Cria evento

`POST` `/events`

Cadastra um novo evento

## Corpo da requisição

- **event** (`object`, obrigatório)
  - **timestamp** (`date-time | null`) — Data e hora em que o evento foi gerado no formato [ISO 8601](https://pt.wikipedia.org/wiki/ISO_8601). Se não for enviado, o horário atual será usado. O prazo máximo para envio retroativo (backfill) é 24 horas. Horários no futuro não são permitidos.
  - **id** (`string`, obrigatório) — Código identificador único da entidade. Reutilize o mesmo código para enviar eventos diferentes na mesma entidade.
  - **type** (`string`, obrigatório) — ID do tipo do evento
  - **attributes** (`object`, obrigatório) — Dados do evento de acordo com os campos configurados.
  - **rule** (`object | null`) — Informe, opcionalmente, a regra a ser aplicada.
    - **name** (`string | null`) — Nome da regra, conforme cadastrado previamente. Se a regra informada não existir, não possuir versão ativa publicada ou não pertencer a este tipo de evento, a requisição não irá falhar e nenhuma regra será executada.

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

## Respostas

### 201 — Evento criado com sucesso

### 401 — Credenciais de acesso inválidas

- **errors** (`array`)
  - **field** (`string`) — Campo da requisição onde ocorreu o erro
  - **type** (`string`) — Código do tipo do erro
  - **message** (`string`) — Mensagem do erro

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

### 422 — Parâmetros inválidos

- **errors** (`array`)
  - **field** (`string`) — Campo da requisição onde ocorreu o erro
  - **type** (`string`) — Código do tipo do erro
  - **message** (`string`) — Mensagem do erro

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