La API de Holded permite que otras aplicaciones consulten y creen información en tu cuenta (facturas, contactos, productos, stock, tesorería, contabilidad) mediante peticiones REST en JSON autenticadas con un token. La versión lanzada en junio de 2026 documenta 356 endpoints, paginación por cursor, webhooks en tiempo real, SDKs oficiales y un servidor MCP para conectar asistentes de IA como Claude o ChatGPT. Es la pieza que convierte Holded en el centro de un sistema conectado, pero no siempre es la opción adecuada: muchas necesidades se cubren con integraciones nativas o con Make y Zapier.
Qué ha cambiado en 2026
Holded ha renovado su portal de desarrolladores con una API v2 orientada a recursos. Según su documentación:
| Elemento | Qué ofrece |
|---|---|
| API REST / JSON | 356 endpoints sobre ventas, compras, contactos, productos, stock, tesorería, contabilidad y equipo |
| Autenticación | Token tipo Bearer generado desde la propia cuenta |
| Paginación | Por cursor, para recorrer listados grandes |
| Límites | Varias ventanas de uso y un límite mensual según el plan contratado |
| Webhooks | Eventos en tiempo real (facturas, oportunidades, inventario) con reintentos |
| SDKs oficiales | TypeScript, Python, Go y PHP, generados desde la especificación OpenAPI |
| Servidor MCP | Conecta asistentes de IA a los datos de Holded |
La API anterior (v1) está marcada como obsoleta, aunque sigue disponible para integraciones existentes. Si tienes desarrollos antiguos, conviene planificar su migración.
Casos en los que la API tiene sentido
- Ecommerce o plataformas propias sin conector nativo: crear pedidos y facturas en Holded desde tu web.
- CRM externo: sincronizar contactos y oportunidades cuando el conector vía Zapier se queda corto.
- Cuadros de mando: extraer ventas, cobros y tesorería hacia Power BI, Looker Studio o un ERP interno.
- Facturación desde otro sistema: plataformas de reservas, software sectorial o herramientas de proyectos que generan la factura en Holded.
- Reacción a eventos: con webhooks, avisar al equipo o lanzar un flujo cuando se crea o se paga una factura.
- Stock multicanal: mantener existencias coherentes entre almacenes y canales de venta.
Qué aporta el servidor MCP
MCP (Model Context Protocol) es un estándar abierto para que los asistentes de IA usen herramientas externas de forma estructurada. Holded anuncia su servidor MCP como la forma de conectar Claude, ChatGPT, Cursor o cualquier agente a tu cuenta para preguntar, crear y analizar en lenguaje natural.
En la práctica abre usos como:
- Consultar "¿qué facturas vencen esta semana y de qué clientes?" sin montar un informe.
- Preparar borradores de presupuesto a partir de una conversación.
- Revisar desviaciones de gastos o la rentabilidad de proyectos.
El interés de búsqueda por "Holded MCP" se ha multiplicado en el último año, pero conviene ir con cuidado: un asistente con acceso de escritura a tu facturación es un riesgo si no se limitan los permisos. Lo prudente es empezar con permisos de solo lectura y casos de consulta, y ampliar cuando el uso esté claro. Si estás eligiendo asistente, te puede ayudar qué IA elegir para tu empresa.
Seguridad del token: lo que no se puede pasar por alto
La ayuda de Holded es clara en dos puntos:
- El token no hereda los permisos del usuario. Los permisos (lectura, escritura o ambos por módulo) se definen al crear el token.
- Cualquiera que tenga el token puede acceder a todos los endpoints que ese token permita.
Buenas prácticas:
- Un token por integración, con el mínimo permiso necesario.
- Guardarlo en un gestor de secretos o de contraseñas, nunca en un Excel ni en el código fuente. Ver riesgos de compartir contraseñas en Excel.
- Revocar los tokens de integraciones que ya no se usan.
- Revisar periódicamente el uso de la API desde Configuración → Desarrolladores, para detectar consumos anómalos y no agotar el límite del plan.
La API está disponible en los planes de pago y en el periodo de prueba, no en el plan gratuito.
API, conector nativo o Make/Zapier: cómo decidir
| Situación | Opción recomendada |
|---|---|
| Existe integración nativa (Shopify, WooCommerce, PrestaShop, Stripe, Google Drive…) | Conector nativo |
| Flujo sencillo entre dos aplicaciones populares | Zapier o Make |
| Varios pasos, lógica condicional, control de errores o volumen alto | n8n o Make sobre la API |
| Integración crítica con un sistema propio o sectorial | Desarrollo sobre la API, con webhooks |
| Consulta y análisis en lenguaje natural | Servidor MCP con permisos de lectura |
Lo comparamos con más detalle en automatizar Holded con n8n, Make o Zapier.
Errores habituales en integraciones con la API
- Crear facturas sin respetar series ni campos obligatorios de Verifactu (ver Verifactu en Holded).
- Duplicar contactos porque no se busca antes de crear.
- No tratar errores ni reintentos: el flujo falla en silencio y nadie se entera.
- Hacer consultas masivas sin paginación ni caché, y agotar el límite de uso.
- Dejar el desarrollo sin documentar ni propietario interno.
Integra Holded con criterio
En Kualum diseñamos integraciones y automatizaciones con Holded: revisamos la viabilidad, los permisos y el plan necesario antes de presupuestar, y elegimos la opción más sencilla que resuelva el problema, sea un conector nativo, Make, n8n o un desarrollo sobre la API.
👉 Consulta nuestros servicios de integración de Holded.
