> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finup.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Claves API

> Crear y gestionar API keys para conectar FinUp con otros sistemas (ERP, CRM, scripts).

# Claves API

Las **API keys** permiten que sistemas externos (ERP, CRM, scripts,
automatizaciones) operen sobre tu negocio en FinUp **sin que un empleado inicie
sesión** en el navegador. Se administran desde **API Keys** en el menú
**Administración** (sólo **administradores**).

## Crear una clave

1. **API Keys → Nueva API key**.
2. Ponele un **nombre** descriptivo (ej. "Integración ERP", "Conciliación
   nocturna").
3. Elegí el **acceso**:
   * **Solo lectura (GET):** sólo puede consultar datos. Rechaza altas y
     modificaciones.
   * **Acceso total (lectura y escritura):** puede crear y modificar datos.
4. Al confirmar, FinUp muestra la **clave completa una sola vez**. Copiala y
   guardala en un lugar seguro (gestor de contraseñas): **no se vuelve a
   mostrar**.

## Cómo se usa

Enviá la clave en cada request, con el header:

```http theme={null}
Authorization: Bearer finup_xxxxxxxxxxxxxxxxxxxxxxxx
```

o, alternativamente:

```http theme={null}
X-API-Key: finup_xxxxxxxxxxxxxxxxxxxxxxxx
```

## La lista de claves

De cada clave ves:

* **Nombre** y **prefijo** (una parte inicial, para identificarla sin exponer el
  secreto),
* **Acceso** (solo lectura / acceso total),
* **Creada** y **último uso**,
* **Estado** (activa o revocada).

## Revocar

**Revocar** desactiva la clave de inmediato: cualquier integración que la use
deja de funcionar. La baja es **permanente** (no se puede reactivar la misma
clave). Si necesitás volver a conectar, creá una nueva.

<Warning>
  Tratá la clave como una contraseña:

  * No la pongas en código que llega al navegador ni en repositorios públicos.
  * Usá una clave distinta por integración o entorno.
  * Si sospechás que se filtró, **revocala y creá otra**.
</Warning>

## Próximo paso

La documentación técnica (endpoints, parámetros y ejemplos en varios lenguajes)
está en la pestaña **API Reference** de este portal. Empezá por el
[Quickstart](/api/quickstart).