> ## Documentation Index
> Fetch the complete documentation index at: https://docs.softcrum.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart: envía tu primer evento

> Envía eventos de comportamiento a Softcrum en cinco minutos.

## 1. Obtén tu API key

Crea un rol de máquina con el permiso `core.events.write` en la Consola y emite una API key.

## 2. Envía un evento

```bash theme={null}
curl -X POST https://api.softcrum.com/v1/core/track \
  -H "Authorization: Bearer $SOFTCRUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "invoice_paid",
    "external_id": "cust_1042",
    "idempotency_key": "inv_889-paid",
    "occurred_at": "2026-08-15T14:03:00-04:00",
    "properties": { "amount": 45990, "currency": "CLP", "invoice_id": "inv_889" }
  }'
```

La API responde `202 Accepted` con un `event_id` — el procesamiento (perfiles, segmentos, reglas
de fidelización, notificaciones) ocurre de forma asíncrona en cuestión de segundos.

## 3. Observa los efectos

Abre el timeline del contacto en la Consola: el evento, los puntos acreditados y los mensajes
enviados aparecen encadenados por el mismo correlation id.

<Note>Reintentar es seguro: el mismo `idempotency_key` nunca crea un duplicado.</Note>