Tu API Key es la llave que conecta Holded con todo lo demás.
Qué es, dónde encontrarla y cómo crearla paso a paso — y cómo usarla sin comprometer tu cuenta.
David GonzálezSi quieres conectar Holded con otra herramienta —un software de reporting, una tienda online, un CRM o tu propio script— hay una pieza que necesitas sí o sí: la API Key de Holded. Es la credencial que identifica tu cuenta y autoriza a esa herramienta a leer (y, en algunos casos, escribir) tus datos. Sin ella, ninguna integración es posible.
La buena noticia es que conseguirla sigue siendo rápido: un minuto dentro del panel de Holded y no hace falta saber programar. La parte importante no es crearla, sino entender qué permisos tiene y cómo usarla sin comprometer la seguridad de tu cuenta.
En esta guía vemos qué es exactamente la API Key, para qué sirve, cómo crearla paso a paso, en qué se diferencia una clave de lectura de una de escritura y qué buenas prácticas conviene seguir. Si quieres una visión más amplia del tema, puedes empezar por nuestro artículo sobre qué es la API de Holded. Y si tu integración es anterior a 2026, revisa la guía de migración de la API de Holded a la v2.
En pocas palabras: Piensa en la API Key como una llave digital con permisos: no es tu contraseña personal, pero quien la tenga puede acceder a los datos que autorices. Si un proveedor te la solicita, puedes revisar aquí qué debe explicar, cómo limitar su uso y cómo revocarla; no tienes que desarrollar la conexión tú mismo.
Qué es la API Key de Holded
Una API Key —o clave de API— es un código alfanumérico único que funciona como la credencial de tu cuenta de Holded. Cada vez que una aplicación externa hace una petición a la API de Holded, incluye esa clave para demostrar a qué cuenta pertenece la operación y que está autorizada a realizarla.
Es, en esencia, una contraseña pensada para máquinas. A diferencia de tu usuario y contraseña habituales —que sirven para que entres tú por el navegador—, la API Key permite que un programa se conecte en tu nombre, sin intervención humana y de forma continua. Por eso es tan potente, y por eso hay que tratarla con el mismo cuidado que una contraseña.
Para qué sirve tu API Key de Holded
La API Key es la puerta de entrada a todo lo que Holded puede hacer más allá de su propia interfaz. Con ella, una aplicación autorizada puede acceder a tu facturación, contactos, productos, contabilidad o proyectos de forma programática — todo lo que recoge la documentación oficial para desarrolladores de Holded. Estos son los tres usos más habituales:
Esa última idea —que varias herramientas dejen de ser islas y funcionen como un sistema único— es lo que se conoce como integraciones financieras. La API Key es la pieza técnica que las hace posibles: desde conectar tu ERP con un dashboard hasta alimentar un cuadro de mando en tiempo real.
Antes de empezar: requisitos
Crear una API Key en Holded es sencillo, pero no todas las cuentas ni todos los usuarios pueden hacerlo. Antes de entrar al panel, comprueba que cumples estas condiciones:
Cómo conseguir tu API Key de Holded paso a paso
Con los requisitos cubiertos, generar la credencial es cuestión de un minuto. Sigue estos seis pasos dentro de Holded —el propio centro de ayuda de Holded los documenta también de forma oficial:
Inicia sesión en Holded desde el navegador. Arriba a la izquierda, sobre el menú lateral, pulsa el nombre de tu cuenta y elige Configuración.
Configuración se abre en un panel lateral con ocho tarjetas. La que buscas es Desarrolladores.
Dentro de Desarrolladores hay tres opciones: Credenciales, Uso de la API y Webhooks. La ruta completa es Configuración → Desarrolladores → Credenciales.
El botón azul está arriba a la derecha del panel. Verás también un aviso de que las API Keys v1 han quedado obsoletas: esas son las antiguas, no tires por ahí.
Escribe una Descripción que identifique para qué es la credencial —por ejemplo, «Integración Numio»—. En Permisos eliges el ámbito: Global (una sola fila, Todo) o Por áreas (Ventas, Contabilidad, Contactos…). En cada fila abres el desplegable y marcas None, Leer, Escribir o Full. Después, Crear Token.
Holded genera un código que empieza por pat_: ese es tu API Token. Cópialo entero en ese momento, porque después solo te muestra el principio y no hay forma de recuperarlo. Trátalo como una contraseña: no lo dejes en un email ni en un documento compartido.
Genera y copia tu API Token de Holded
Es la llave que permite a Numio leer tus datos, y se crea desde tu cuenta de Holded. Aquí te enseñamos los 6 pasos sobre una recreación de sus pantallas; luego los repites en la tuya.
Abre el menú de tu cuenta
Arriba a la izquierda, sobre el menú lateral, pulsa el nombre de tu cuenta y elige Configuración.
Entra en Desarrolladores
Configuración se abre en un panel a la derecha. Abajo a la izquierda de ese panel está Desarrolladores.
Abre Credenciales
Dentro de Desarrolladores verás tres opciones. La primera, Credenciales, es la que necesitas.
Agregar API Token
Pulsa el botón azul Agregar API Token, arriba a la derecha del panel. Ignora el aviso de las API Keys v1: son las antiguas y ya no sirven.
Global y Full
Pon una Descripción (por ejemplo, Numio). En Permisos cambia a Global, y en la fila Todo abre el desplegable y elige Full. Después, Crear Token.
Copia el token
El token empieza por pat_. Cópialo entero ahora: después Holded solo te enseña el principio.
Los permisos del token: ámbito y nivel
Aquí está el cambio más importante frente a las antiguas API Keys. Antes los permisos dependían del orden de creación: la primera clave era de lectura y escritura y las siguientes de solo lectura. Eso ya no es así. Ahora cada token declara sus permisos al crearlo, y se combinan dos decisiones.
La regla práctica no cambia: da el mínimo que la integración necesite. Para un software de reporting o un cuadro de mando basta con Leer; aunque el token llegara a filtrarse, nadie podría alterar tu contabilidad. Reserva Escribir o Full para las integraciones que de verdad tengan que crear o modificar registros.
Cómo usar tu API Key de forma segura
Una API Key activa es una llave permanente a tu cuenta: mientras no la revoques, sigue funcionando. Estos son los errores de seguridad más habituales —y más fáciles de evitar—:
Pegar la clave en un repositorio de GitHub, en un script compartido o en el código de una web. Los bots rastrean claves expuestas en cuestión de minutos.
Enviarla por email, chat o documentos sin control. Una vez fuera, no sabes cuántas copias existen ni quién las tiene.
Reutilizar la misma API Key en varias integraciones. Si una se compromete, tienes que revocarla y reconfigurarlas todas. Una clave por integración acota el problema.
Dejar activas claves de herramientas que ya no utilizas. Cada clave viva es una puerta abierta: si no se usa, se revoca.
La regla es simple: una clave con nombre claro por cada integración, entregada solo a herramientas de confianza y revocada en cuanto deja de hacer falta. Revocar una API Key es inmediato y se hace desde la misma pantalla de Desarrolladores donde la creaste.
Conectar Holded con Numio usando tu API Key
Uno de los usos más frecuentes de la API Key de Holded es conectar la contabilidad con una herramienta de análisis financiero. Numio es justamente eso: una plataforma que se conecta a Holded mediante tu API Key y convierte los datos de tu ERP en dashboards, balances, cuenta de resultados y previsiones de tesorería, sin que tengas que exportar nada a mano. Si lo que buscas es sacar los datos tú mismo, aquí tienes el detalle: cómo exportar los datos de Holded por API.
La conexión se hace una sola vez: pegas tu API Key en el alta de Numio y, a partir de ahí, la sincronización es automática. Numio guarda esa clave cifrada y trabaja en modo lectura, así que nunca modifica nada en tu Holded.
Para una empresa, esto significa ver sus finanzas sin pelearse con hojas de cálculo. Para una asesoría, significa ofrecer reporting financiero a toda su cartera conectando el Holded de cada cliente con una integración estándar.
Preguntas frecuentes sobre la API Key de Holded
¿Qué es la API Key de Holded?
¿Dónde se encuentra la API Key en Holded?
¿Es gratis crear una API Key en Holded?
¿Cuántas API Keys puedo crear?
¿La API Key de Holded caduca?
¿Tiene límite de llamadas o rate limit?
¿Es seguro dar mi API Key a una herramienta externa?
Conclusión
Conseguir tu credencial de Holded es, técnicamente, lo más fácil de cualquier integración: un par de minutos en Configuración → Desarrolladores → Credenciales y ya la tienes. Lo que de verdad marca la diferencia es usarla bien — entender sus permisos, nombrarla con criterio, entregarla solo a herramientas de confianza y revocarla cuando ya no sirve.
Con esa clave en la mano, tu Holded deja de ser una isla: puede conectarse con tu tienda, con tu CRM o, como con Numio, con la herramienta que convierte tu contabilidad en información para decidir. Si quieres entender mejor el ecosistema sobre el que se construyen estas integraciones, el siguiente paso natural es nuestro artículo sobre qué es la API de Holded.
Conecta tu Holded con Numio
Con solo tu API Key, Numio convierte la contabilidad de tu empresa en dashboards y previsiones siempre al día, en solo lectura.
Prueba Numio 30 días gratisSin tarjeta y sin permanencia, desde 39€/mes. ¿Llevas la contabilidad de clientes? Reserva una demo para asesorías.