Claves API

Crear claves de acceso por HTTP para tus integraciones, con permisos por sección, copiar la Base URL y la cabecera de autenticación y comprobar la conexión con whoami.

Una clave API da acceso por HTTP a las secciones que le permitas. La usan la API REST, el SDK .NET y las conexiones con n8n, Make y Zapier.

Antes de empezar

Ser Administrador de la empresa.
Una clave por integración: así retiras una sin afectar a las demás.

Crear una clave

Pulsa el botón de añadir

En Administración → Claves API, en el listado Claves API.

El nombre del sistema que la usa, el empleado a cuyo nombre quedan sus escrituras y los permisos por sección. Marca Compatible WebHook si la clave va a llamar a la Base URL, recibir webhooks salientes o usarse en el playground de Desarrollo. La clave se genera al guardar.

Copia los datos de conexión

La tarjeta Cómo conectar da la Base URL de tu empresa, la cabecera de Autenticación y el Content-Type (application/json). La cabecera lleva un token, no la clave: copia la cabecera completa con su botón. Es la de la primera clave con Compatible WebHook, secreto y empleado por defecto; sin ninguna, el comando lleva TU_TOKEN.

Comprueba la conexión

Pulsa Copiar el comando y pégalo en una terminal. Llama a whoami, que responde con el usuario de la clave si el token funciona.

Si responde 401

Marca Compatible WebHook en la ficha de la clave. Crear, cambiar o retirar una clave tarda hasta 120 segundos en aplicarse.

Cómo se usa

Cada petición lleva el token en la cabecera:

Authorization: Bearer <token>

Las escrituras quedan a nombre del empleado de la clave. Para probarla sin código: Webhooks Entrantes.

Retirar una clave

Elimínala de la lista. Sus peticiones reciben 401 en cuanto se aplica; las demás claves siguen igual.