# ¿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.

Abrir en Kinmu: <https://my.kinmu.app/es/dashboard/company#public-api>

## En la web

1. ### Abre **Mi empresa**

   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.

2. ### Abre **API pública**

   En la página **Mi empresa**, en **Extensiones**, abre **API pública**.

   Se abre la pestaña **API keys**.

   ![Crear API key disponible en la lista de claves](https://kinmu.app/help/es/k0028-02.webp)

3. ### Empieza una key nueva

   Pulsa **Crear API key**.

   Se abre el formulario para crear la clave.

   ![Nombre vacío y producción seleccionada al crear una API key](https://kinmu.app/help/es/k0028-03.webp)

4. ### 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.

   ![Nombre completado y producción seleccionada al crear una API key](https://kinmu.app/help/es/k0028-04.webp)

5. ### 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.

   ![Opciones de expiración desplegadas al crear una API key](https://kinmu.app/help/es/k0028-05.webp)

6. ### Elige los permisos

   En **Permisos**, marca solo los que necesita tu integración, como **Empleados (lectura)**.

   Los permisos elegidos quedan marcados.

   ![Permiso de lectura de empleados activado en la API key](https://kinmu.app/help/es/k0028-06.webp)

7. ### Crea la key

   Pulsa **Crear key**.

   Después de pulsar el botón, ves “Copia tu API key ahora” con la key completa.

8. ### 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](https://docs.kinmu.app/).