API de Proyectos y Tableros
Cómo crear tableros, columnas, grupos e ítems del módulo de Proyectos de Omnifox por API.
Mira este paso en el video · CRM y calendario por API
El módulo de Proyectos (Tableros estilo Monday) organiza trabajo en tableros con grupos, columnas tipadas e ítems. La API REST permite automatizar la creación de tareas desde otros sistemas (por ejemplo, crear un ítem cuando llega un ticket o se gana una oportunidad de CRM).
Requisitos
- El workspace debe tener el feature
projects_enabledde su plan; sin él, los endpoints devuelven403. - Token Bearer del workspace.
Endpoints principales
GET/POST /api/v1/boards— listar o crear tableros.GET /api/v1/boards/column-types— tipos de columna disponibles (texto, estado, persona, fecha, número, etc.).POST /api/v1/boards/{board}/groups— crear un grupo (sección) dentro del tablero.POST /api/v1/boards/{board}/columns— agregar una columna.POST /api/v1/boards/{board}/items— crear un ítem (tarea).PUT /api/v1/boards/items/{item}/columns/{column}— actualizar el valor de una columna en un ítem.PATCH /api/v1/boards/items/{item}/move— mover un ítem entre grupos.POST /api/v1/boards/items/{item}/subitems— crear subítems.
Ejemplo: crear un ítem en un tablero
curl -X POST "https://app.omnifox.io/api/v1/boards/8/items" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Preparar propuesta comercial",
"group_id": 22,
"contact_id": 55
}'
Un ítem puede llevar contact_id y/o deal_id para enlazarlo con un contacto o una oportunidad del CRM.
Consejos
- Consulta
GET /api/v1/boards/{board}/viewpara traer el tablero completo (grupos, columnas e ítems) en una sola llamada, ideal para dashboards externos. - Las automatizaciones del tablero (
/api/v1/boards/{board}/automations) pueden crear o mover ítems solas quen ocurre un evento; revisa el catálogo conGET .../automations/catalogantes de armar una regla nueva.
Solución de problemas
- 403 en
/boards/*: el plan del workspace no incluye Proyectos. - La columna no acepta el valor enviado: cada tipo de columna (estado, persona, fecha…) espera un formato distinto; consulta
GET /api/v1/boards/column-typespara ver el esquema exacto. - El ítem no se mueve de grupo: usa
PATCH .../move(noPUT) e incluye elgroup_iddestino.
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.