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

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

## En la web

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

   En el celular, abre primero el menú desde el botón de menú.

   En el menú lateral.

2. ### 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:

   ![Botón Crear API key disponible en la lista de API keys](https://kinmu.app/help/mx/k0028-02.webp)

3. ### Empieza una key nueva

   Presiona **Crear API key**.

   Después de seleccionarlo:

   ![Nombre vacío y Producción seleccionada en Crear API key](https://kinmu.app/help/mx/k0028-03.webp)

4. ### Escribe un nombre

   Completa **Nombre** con un nombre que identifique la integración.

   ![Nombre completado y Producción seleccionada en Crear API key](https://kinmu.app/help/mx/k0028-04.webp)

   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.

5. ### Elige la expiración

   En **Expiración**, elige cuántos días funcionará la key o **Sin expiración**.

   Después de seleccionarlo:

   ![Opciones de Expiración desplegadas en Crear API key](https://kinmu.app/help/mx/k0028-05.webp)

   Si eliges un plazo, la key dejará de funcionar automáticamente cuando venza.

6. ### Elige los permisos

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

   Después de seleccionarlo:

   ![Empleados (lectura) activado en los permisos de la API key](https://kinmu.app/help/mx/k0028-06.webp)

7. ### Crea la key

   Presiona **Crear key**.

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

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