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:

  1. Ponle un nombre que identifique la integración (por ejemplo, «ERP» o «Tablero de ventas»).
  2. Elige los permisos que necesita. Solo los que vaya a usar.
  3. 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