API

Integrá Lumos en tu stack

API REST con autenticación por token y webhooks firmados para notificar eventos en tiempo real. Compatible con cualquier ATS o HRIS.

Autenticación

Bearer token por organización, con scopes granulares y rotación desde el panel.

API REST

Endpoints JSON documentados: evaluaciones, invitaciones, candidatos y reportes.

Webhooks

Eventos firmados HMAC-SHA256 con reintentos exponenciales para candidato.completado, evaluación.creada y más.

Ejemplo — Crear una invitación

Envía una invitación a un candidato para una evaluación existente.

POST https://api.lumostest.com/v1/invitations
Authorization: Bearer sk_live_xxx
Content-Type: application/json

{
  "evaluation_id": "eval_01H8...",
  "candidate": {
    "name": "María López",
    "email": "maria@empresa.com",
    "cedula": "1-2345-6789"
  },
  "notify_on_complete": true
}

// 201 Created
{
  "id": "inv_01H9...",
  "token": "tok_abc123",
  "status": "pending",
  "invite_url": "https://app.lumostest.com/prueba/tok_abc123",
  "expires_at": "2026-08-15T10:30:00Z"
}

Webhook — Candidato completó evaluación

POST https://tu-app.com/webhooks/lumos
X-Lumos-Signature: sha256=abc123...
Content-Type: application/json

{
  "event": "invitation.completed",
  "created_at": "2026-08-01T14:22:31Z",
  "data": {
    "invitation_id": "inv_01H9...",
    "candidate_email": "maria@empresa.com",
    "score": 87,
    "report_url": "https://app.lumostest.com/reporte/inv_01H9..."
  }
}

¿Querés acceso a la API?

El acceso a la API está disponible en los planes Pro y Enterprise. Contactá al equipo para obtener tu token.

Solicitar acceso