Guía rápida

Tu primer request autenticado

De cero a una respuesta real de la API en cinco pasos.

1. Confirmá tu plan

La API pública requiere un workspace en plan Pro, Business o Custom. Si tu workspace está en Free o Starter, vas a poder crear el token en el paso siguiente, pero cualquier request devolverá 402 plan_limit_reached hasta que mejores de plan.

2. Creá un token

Andá a Configuración → Developers dentro de Loona y hacé click en Crear token. Elegí:

Un nombre descriptivo (por ejemplo, “Integración con Zapier”).
Permisos: read para sólo consultar, write para además crear/modificar (incluye lectura).
Un vencimiento: 30 días, 90 días, 1 año, o sin vencimiento.

Copialo ahora

El valor completo del token sólo se muestra una vez, en el momento de crearlo. Loona guarda un hash, no el token en claro — si lo perdés, no hay forma de recuperarlo: hay que revocarlo y crear uno nuevo.

3. Probalo con /me

Es el “hello world” de la API: confirma que el token es válido y contra qué workspace apunta, antes de escribir la integración de verdad.

GET/api/v1/me

curl

curl https://tu-dominio.com/api/v1/me \
  -H "Authorization: Bearer lna_live_..."

200 OK

{
  "workspace": { "id": "...", "name": "Estudio Norte", "slug": "estudio-norte", "plan": "pro" },
  "token": { "scopes": ["read", "write"] }
}

4. Listá tus clientes

GET/api/v1/clients

curl

curl "https://tu-dominio.com/api/v1/clients?limit=20" \
  -H "Authorization: Bearer lna_live_..."

5. Creá un cliente

Requiere un token con permiso de escritura.

POST/api/v1/clients

curl

curl -X POST https://tu-dominio.com/api/v1/clients \
  -H "Authorization: Bearer lna_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Estudio Norte",
    "email": "[email protected]",
    "monthly_value": 45000,
    "currency": "ARS"
  }'

La respuesta viene con 201 Created, y dispara el mismo webhook client.created que un cliente creado desde la UI.

Leé Autenticación para entender los scopes en detalle, o revisá la referencia completa de Clientes, Contactos y Pipeline para ver todos los parámetros y campos disponibles.

AnteriorIntroducción Siguiente Autenticación