¿Cómo creo una credencial de API para una integración?
En Kinmu, entra en Mi empresa, abre API pública, pulsa Crear API key, define el nombre, la expiración y los permisos, y copia la key, que solo se muestra una vez.
En esta página
En la web
Abre Mi empresa Abrir en Kinmu Si tu empresa tiene API pública.
En el móvil, abre primero el menú desde el botón de menú.
En el menú lateral.
Se abre la configuración de la empresa.
Abre API pública
En la página Mi empresa, en Extensiones, abre API pública.
Se abre la pestaña API keys.
Empieza una key nueva
Pulsa Crear API key.
Se abre el formulario para crear la clave.
Escribe un nombre
Completa Nombre con un nombre que identifique la integración.
El nombre aparece en el panel. Si ves Producción y Sandbox, elige el entorno. Sandbox opera sobre una empresa de prueba con datos sintéticos.
Elige la expiración
En Expiración, elige cuántos días funcionará la key o Sin expiración.
Si eliges un plazo, la key dejará de funcionar automáticamente cuando venza.
Elige los permisos
En Permisos, marca solo los que necesita tu integración, como Empleados (lectura).
Los permisos elegidos quedan marcados.
Crea la key
Pulsa Crear key.
Después de pulsar el botón, ves “Copia tu API key ahora” con la key completa.
Copia la key
Pulsa Copiar, guarda la key en un lugar seguro y pulsa Hecho.
La key aparece en la lista, oculta. Kinmu no volverá a mostrarla.
Si no lo ves
- API pública necesita la extensión API pública, que se activa en Mi empresa › Extensiones.
- Roles necesarios: Administrador Global, Manager de Empresa.
- Si Crear API key está desactivado, llegaste al máximo de keys activas. Revoca alguna para crear una nueva.
- Si ves “Selecciona al menos un permiso.”, marca al menos un permiso antes de crear la key.
Preguntas frecuentes
Perdí la key. ¿Cómo la recupero?
No se puede volver a ver. Abre la key en la lista y pulsa Rotar para obtener una nueva con los mismos permisos, o crea otra key. La anterior deja de funcionar de inmediato, así que actualiza tus integraciones.
¿Cómo evito que una integración siga usando una key?
Abre la key y pulsa Revocar. La key deja de funcionar de inmediato y no se puede deshacer.
Resultado
La key nueva aparece en API keys con su estado. Tu integración lo envía en el encabezado Authorization: Bearer de cada solicitud. La referencia técnica está en docs.kinmu.app.
¿No lo encuentras? Escríbenos