¿Cómo creo una API key para una integración?
En Kinmu, entra a Mi empresa, abre API pública, presiona 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 celular, abre primero el menú desde el botón de menú.
En el menú lateral.
Abre API pública
En la página Mi empresa, en Extensiones, abre API pública.
Se abre la pestaña API keys.
Después de seleccionarlo: 
Empieza una key nueva
Presiona Crear API key.
Después de seleccionarlo: 
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.
Después de seleccionarlo: 
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).
Después de seleccionarlo: 
Crea la key
Presiona Crear key.
Después de presionar el botón, ves “Copia tu API key ahora” con la key completa.
Copia la key
Presiona Copiar, guarda la key en un lugar seguro y presiona Listo.
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 presiona 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 presiona 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 la envía en el encabezado Authorization: Bearer de cada solicitud. La referencia técnica está en docs.kinmu.app.
¿No lo encuentras? Escríbenos