Skip to main content

​
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:
o, alternativamente:

​
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.
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.

​
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.