Holded API: 5 ejemplos de automatización que sí merecen la pena
Cinco automatizaciones con la API de Holded que resuelven problemas reales de tu pyme: compras, banco, CRM y Verifactu. Con endpoints y lógica concreta.
Tienes la facturación en Holded, los leads en tu CRM y las campañas en Meta o Google. Tres pantallas que no se hablan. Quizá has leído que con MCP una IA puede conectarse directamente a Holded y darte respuestas sobre tus facturas, pagos y clientes sin abrir la aplicación. Es verdad — pero Holded MCP no es algo que exista como producto oficial. Hay alternativas reales, pero requieren saber qué haces. Te cuento cuáles son y cómo conectar Holded con inteligencia artificial sin entregar las llaves de tu facturación.
MCP son las siglas de Model Context Protocol, un estándar abierto que define cómo una IA se conecta a herramientas externas. En lugar de copiar datos manualmente de Holded a un chat con la IA, MCP permite que la IA acceda directamente al servicio, lea la información que necesita y te dé una respuesta sin que hagas de intermediario.
Piensa en ello como un enchufe universal. Sin MCP, cada conexión entre una IA y un servicio externo necesita una integración a medida. Con MCP, el protocolo es el mismo independientemente de la herramienta — lo que cambia es el conector específico de cada servicio.
En la práctica, MCP ya funciona con decenas de herramientas: bases de datos, Google Drive, CRMs, repositorios de código. La cuestión es si funciona con Holded, y ahí hay que matizar.
Holded no ha publicado un MCP oficial. No lo mantiene ni lo soporta.
Lo que sí existe son MCPs de la comunidad: varios proyectos en GitHub y uno de Zapier que actúan como puente entre Holded y herramientas compatibles con MCP. Son proyectos mantenidos por terceros — desarrolladores independientes que han construido el conector.
¿Funcionan? Pueden funcionar. Pero hay algo que debes tener claro antes de usarlos: le estás entregando tu API key de Holded a un software que no controlas. Dependiendo de los permisos de ese token, eso puede significar acceso a todas tus facturas, contactos, pagos y movimientos bancarios.
Nosotros no usamos MCPs comunitarios. Montamos la conexión directamente sobre la API v2 de Holded, con un token que configuramos con permisos específicos — por defecto, de solo lectura — y sin que ningún intermediario vea las llaves de tu facturación. La diferencia no es el resultado (la IA accede a los datos), sino quién controla el acceso. Somos Solution Partner oficial de Holded y lo que hacemos es conectar Holded al CRM y a la publicidad, no vender licencias sueltas.
Cuando la IA tiene acceso de lectura a la API v2 de Holded, puede consultar en tiempo real:
verifactu_status si lo tienes activo).reconciliation_status).En el día a día, esto se traduce en preguntas que la IA responde sin que abras Holded:
«¿Cuánto hemos facturado este trimestre?» — consulta las facturas, suma y responde.
«¿Qué facturas llevan más de 30 días sin cobrar?» — cruza pagos pendientes con fechas y lista las morosas.
«Este cliente pide un presupuesto parecido al del mes pasado» — busca el presupuesto anterior y te resume las partidas.
Si se decide habilitar escritura limitada — algo que solo hacemos con autorización explícita y sobre operaciones concretas —, la documentación de la API recoge la posibilidad de crear y aprobar facturas de venta, registrar pagos, crear compras y conciliar movimientos bancarios. Pero eso se configura operación por operación, nunca con barra libre.
La API v2 de Holded (base api.holded.com/api/v2) usa autenticación Bearer. Cada token tiene permisos granulares: defines si el alcance es global o por áreas, y dentro de cada área eliges entre ningún acceso, solo lectura, escritura o acceso completo. Las áreas son 11.
Esto te permite crear un token que solo lea facturas y contactos, sin tocar la contabilidad ni los movimientos bancarios. O uno que lea todo pero no escriba nada. Tú decides el perímetro.
Las respuestas vienen paginadas (con estructura {"items": [...]}), los campos en snake_case, y si te pasas de los límites de uso, Holded responde con un 429 y una cabecera Retry-After que indica cuándo volver a llamar. También tiene webhooks para recibir notificaciones en tiempo real cuando algo cambia — una factura cobrada, un presupuesto aceptado.
Un detalle técnico que importa: los tokens nuevos (los que empiezan por pat_) solo funcionan con la v2. La API v1 sigue existiendo para ciertas cosas que la v2 no cubre — las series de numeración, por ejemplo, solo están en la v1 y se configuran desde la interfaz de Holded.
Conectar una IA a Holded aislado está bien. Pero el salto real ocurre cuando Holded se conecta también al CRM y a las campañas de publicidad.
Ejemplo: llega un lead por Meta Ads. El CRM lo registra, el comercial lo trabaja, cierra la venta. Holded emite la factura. Si esos tres sistemas no se hablan, no puedes saber cuánto te ha costado conseguir ese cliente ni qué margen te deja. Lo calculas a ojo o en un Excel que nadie mantiene.
Cuando la IA puede leer los tres — la publicidad, el CRM y Holded —, responde preguntas que cruzan fuentes: «¿cuál es mi coste de adquisición real contando lo que facturo en Holded?», «¿qué campaña trae clientes que pagan más rápido?». Ese es el dato que cambia decisiones.
Si te interesa cómo funciona esa integración completa, está explicado en la página de integraciones de Holded con los conectores que montamos.
Tiene sentido si:
No tiene sentido si:
Si tu Holded está bien montado y quieres exprimir lo que la API v2 permite, en la guía de la API de Holded entramos en el detalle técnico de cada endpoint.
Si estás valorando conectar Holded a una IA pero no tienes claro por dónde empezar — ni si tiene sentido para tu volumen de facturación —, te ofrecemos un diagnóstico de una hora, sin coste y sin compromiso. Revisamos tu Holded, tu CRM si lo hay, y te decimos qué se puede automatizar y qué no merece la pena tocar.
No. A fecha de hoy, Holded no ha publicado un MCP oficial ni ofrece soporte para conectarse a herramientas de IA mediante este protocolo. Existen MCPs de la comunidad —proyectos en GitHub y uno de Zapier— mantenidos por terceros, pero implican confiarles tu API key. La alternativa es montar la conexión directamente sobre la API v2 de Holded con un token de permisos controlados, que es lo que hacemos nosotros.
Depende de cómo configures el acceso. La API v2 de Holded permite crear tokens con permisos granulares: puedes limitar el alcance a ciertas áreas y restringir el nivel a solo lectura. Un token bien configurado no puede modificar ni borrar nada. Lo importante es no usar un token con permisos completos ni confiárselo a un intermediario que no controles. Nosotros usamos solo lectura por defecto.
Con un token de lectura, la IA puede consultar facturas emitidas, presupuestos, proformas, compras, contactos, pagos con su estado de conciliación, cuentas bancarias y movimientos, proyectos, leads y embudos comerciales, entre otros. También puede leer campos específicos como el estado de Verifactu de cada factura o los pagos pendientes de cada contacto.
Puedes conectar Holded con ChatGPT, pero no a través de MCP. A día de hoy, Claude es la herramienta con mejor soporte nativo para este protocolo. Con ChatGPT, la conexión se hace por otras vías: GPTs personalizados o plataformas de automatización que llaman a la API v2 de Holded. El resultado funcional es similar — la IA lee tus datos —, pero el camino técnico es distinto.
Depende de la vía. Un MCP comunitario ya empaquetado no requiere programar, pero sí entender qué permisos le estás dando y qué riesgos tiene. Montar una conexión controlada sobre la API v2 requiere conocimientos técnicos: crear el token con los permisos correctos, configurar el conector y probarlo. Es un trabajo de implementación que normalmente hace un técnico o una empresa como la nuestra.
Conectamos tus campañas con tu CRM para que optimices a ventas reales. Reserva una reunión de 30 minutos.
Cinco automatizaciones con la API de Holded que resuelven problemas reales de tu pyme: compras, banco, CRM y Verifactu. Con endpoints y lógica concreta.

Un CRM no es solo una agenda digital de contactos. Es el sistema que te permite conectar tu publicidad con tus ventas y tomar decisiones basadas en datos reales.
LinkedIn Ads es la plataforma más cara por clic del mercado. Si no segmentas con criterio, tu presupuesto desaparece en dos días sin un solo lead cualificado.