Inicio rápido
La API de Kellu te permite leer los datos de tu negocio desde tus propios sistemas: clientes, trabajos, visitas, informes, cotizaciones, notas de venta, equipos, catálogo y miembros del equipo. Además puedes recibir avisos en tiempo real con webhooks y conectar agentes de IA.
- Solo lectura. Las claves de API no crean ni modifican datos. Para crear, editar o enviar documentos desde Claude o ChatGPT, usa el conector de IA, que se conecta con tu cuenta en vez de una clave.
- Una clave por integración. Cada clave pertenece a un negocio y solo ve los datos de ese negocio.
- Respuestas en inglés. Nombres de campos, códigos y mensajes de error de la API están en inglés.
Dirección base de la API:
https://api.kellu.co/api/v1
1. Pide el acceso
El acceso a la API se habilita por negocio y lo activa el equipo de Kellu. Pídeselo a tu contacto en
Kellu. Mientras no esté habilitado, no verás la sección API en Configuración y cualquier clave
responde 403 api_access_disabled.
2. Crea una clave
Con el acceso habilitado, el dueño del negocio o un usuario con perfil Administrador entra a Configuración → API → Claves y crea una clave:
- Ponle un nombre que identifique la integración (por ejemplo, «ERP» o «Tablero de ventas»).
- Elige los permisos que necesita. Solo los que vaya a usar.
- Opcional: elige una fecha de vencimiento.
La clave completa (kellu_sk_…) se muestra una sola vez, al crearla. Cópiala y guárdala en un
gestor de secretos. Después solo verás su prefijo (kellu_sk_ + 4 caracteres).
3. Haz tu primera llamada
GET /me no necesita permisos: sirve para comprobar que la clave funciona.
curl https://api.kellu.co/api/v1/me \
-H "Authorization: Bearer kellu_sk_TU_CLAVE"
Respuesta:
{
"data": {
"business": { "id": "cm…", "name": "Mi negocio" },
"apiKey": {
"id": "cm…",
"name": "ERP",
"prefix": "kellu_sk_AbCd",
"scopes": ["clients:read", "work_orders:read"],
"expiresAt": null
}
}
}
Ahora lista tus clientes (requiere el permiso clients:read):
curl "https://api.kellu.co/api/v1/clients?limit=5" \
-H "Authorization: Bearer kellu_sk_TU_CLAVE"
Siguientes pasos
- Autenticación: vencimiento, rotación y límites de uso.
- Paginación y errores: cómo recorrer listas y manejar errores.
- Recursos y operaciones: todo lo que puedes leer.
- Conector de IA: Claude o ChatGPT leyendo y haciendo cambios en tu negocio.
- Referencia interactiva: cada operación con sus parámetros y campos, generada desde el documento OpenAPI.