Documentación
API REST: guía rápida y referencia
Autenticación con clave de API, límites de frecuencia, paginación y referencia OpenAPI 3.1.
Automatización y desarrolladores
API REST para leer y escribir los planes
Proyectos, tareas, asignaciones y dependencias mediante una API REST, con claves de API de permisos limitados y referencia OpenAPI 3.1.
- Disponible
- Gratis, incluida en todas las cuentas
Qué hace
Webhooks y API REST para tus propias automatizaciones
Para todo lo que no tiene una integración lista: un evento firmado en cuanto algo cambia y una API para leer y escribir el plan.
Para qué sirve
- Conectar Planitude con un sistema interno, un ERP o un almacén de datos.
- Lanzar una automatización en cuanto una tarea se completa o se mueve.
- Crear proyectos y tareas desde otra herramienta, sin copiarlos a mano.
De Planitude a Tu sistema
- Cada cambio, venga de la app web, de la API, de MCP o de una importación → Eventos firmados, De Planitude a Tu sistema
En ambas direcciones
- Proyectos, tareas, asignaciones y dependencias ↔ Lectura y escritura con la API REST, En ambas direcciones
Configuración
Cómo se conecta, en tres pasos
Crea una clave de API
En Perfil → Claves de API, de solo lectura o de lectura y escritura, opcionalmente limitada a un espacio de trabajo y con fecha de caducidad.
Registra un webhook
En un proyecto o en todo un espacio de trabajo, eligiendo entre 14 eventos: tareas creadas, completadas o movidas, dependencias, líneas base, comentarios y más.
Recibe y llama
Verifica la firma HMAC-SHA256 de cada evento y llama a la API REST documentada en OpenAPI 3.1.
Requisitos
- Plan
- Gratuito. Todas las integraciones están incluidas en todas las cuentas de Planitude.
- Quién puede conectarla
- Cada usuario, con su propia clave de API. Webhooks de un proyecto: propietario o editor; webhooks del espacio de trabajo: propietario o administrador.
- Qué se necesita
- Un endpoint HTTPS público para recibir los webhooks; para la API, una clave creada en Perfil → Claves de API.
Conviene saber
- Zapier, Make y n8n llegarán próximamente y usarán esta misma API y estos webhooks.
- Las claves y las apps conectadas no pueden eliminar proyectos ni tareas: eliminar sigue siendo cosa de la app web.
Guías y documentación
Documentación
Webhooks: eventos, firmas y reintentos
Catálogo de eventos, verificación de la firma HMAC-SHA256 y entrega con reintentos.
Guía
Las herramientas que conviene conectar a Planitude: guía de integraciones
Integraciones de Planitude: Jira, Azure DevOps, Slack, Teams, calendarios, ChatGPT, Claude y Gemini vía MCP, API y webhooks, archivos .mpp y .xer. Cuál elegir.
Preguntas frecuentes sobre API REST
¿Cómo compruebo que un webhook viene realmente de Planitude?
Cada solicitud lleva una cabecera con una marca de tiempo y la firma HMAC-SHA256 del cuerpo: vuelve a calcularla con el secreto del webhook y descarta las solicitudes demasiado antiguas. La documentación para desarrolladores incluye ejemplos listos para usar.
¿Puede una integración por API eliminar proyectos?
No. Las claves de API y las apps conectadas pueden leer y, con permiso de escritura, crear y actualizar, pero la eliminación de proyectos y tareas se queda en la app web.
¿Las integraciones tienen coste?
No. Todas las integraciones están incluidas en Planitude, que es gratuito. Solo necesitas tu propio acceso a la otra herramienta (por ejemplo, una cuenta de Jira, Slack o Microsoft 365), según sus condiciones.
¿Cómo se desconecta una integración?
Desde la página de la app en el proyecto, con Desconectar, cuando quieras. No se borra nada: las tareas siguen en Planitude, y las incidencias y los mensajes siguen en la otra herramienta. Las apps de IA conectadas se revocan en Perfil → Claves de API.
Las marcas mencionadas (Jira, Azure DevOps, Slack, Microsoft Teams, Microsoft Outlook, Microsoft PowerPoint, Microsoft Project, Visual Studio Code, Google Calendar, Gemini, Apple Calendar, ChatGPT, Codex, Claude, Cursor, Zapier, Make, n8n, Primavera) pertenecen a sus respectivos titulares; Planitude no está afiliada a ellos ni cuenta con su aprobación.