Marketing
Proyectos
Proyectos, secciones y tareas: lo mismo que el equipo ve en Lista, Tablero, Calendario y Cronograma.
Crea proyectos (en blanco o desde una plantilla), agrega tareas con responsables, fechas, etiquetas y dependencias, comenta y liga el proyecto con campañas, páginas o eventos. Cada cambio avisa al equipo igual que en el panel.
| GET | /v1/projects | Lista proyectos con avance, pendientes y atrasadas. Filtros: status, customer_id, search. |
| GET | /v1/projects/templates | Plantillas disponibles (clave, secciones y número de tareas). |
| POST | /v1/projects | Crea un proyecto, opcionalmente desde una plantilla. |
| GET | /v1/projects/{id} | Proyecto con secciones, tareas y lo ligado con sus números. |
| PUT | /v1/projects/{id} | Cambia nombre, estado, fechas, responsable o cliente. |
| DELETE | /v1/projects/{id} | Elimina el proyecto con sus tareas. |
| POST | /v1/projects/{id}/sections | Agrega una sección (columna del tablero). |
| POST | /v1/projects/{id}/links | Liga el proyecto o una tarea con una campaña de Meta, página, correo, evento, formulario, oportunidad o cliente. |
| POST | /v1/projects/{id}/tasks | Crea una tarea o subtarea. |
| GET | /v1/project-tasks | Tareas de un proyecto o de todos, con filtros por responsable, estado y fechas. |
| GET | /v1/project-tasks/{id} | Detalle: subtareas, checklist, dependencias, archivos, comentarios, ligas y actividad. |
| PUT | /v1/project-tasks/{id} | Cambia la tarea; status=done la termina. |
| DELETE | /v1/project-tasks/{id} | Elimina la tarea y sus subtareas. |
| POST | /v1/project-tasks/{id}/comments | Comenta; @Nombre o @correo avisa a esa persona. |
| POST | /v1/project-tasks/{id}/checklist | Agrega un punto al checklist. |
Crear un proyecto desde plantilla
Con template, las tareas llegan con sección, prioridad, checklist y fechas calculadas desde anchor_date (el día de inicio, del lanzamiento o del evento, según la plantilla). Plantillas: campaign_launch, webinar_event, agency_client y monthly_content.
curl -X POST https://recaudo.app/api/v1/projects \
-H "Authorization: Bearer sk_live_tu_secret_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Lanzamiento de temporada",
"template": "campaign_launch",
"anchor_date": "2026-12-15",
"customer_id": "uuid-del-cliente"
}'
Campos de una tarea
| Campo | Tipo | Descripción |
|---|---|---|
title |
string | Título (obligatorio al crear). |
description |
string | Descripción con formato Markdown. |
section_id |
uuid | Sección del proyecto; si no se manda, la primera. |
parent_id |
uuid | Tarea principal, para crear una subtarea. |
status |
string | todo, in_progress, review o done. |
priority |
string | low, medium, high o urgent. |
start_date |
date | Fecha de inicio (YYYY-MM-DD). |
due_date |
date | Fecha de entrega (YYYY-MM-DD). |
recurrence |
string | daily, weekly, biweekly, monthly o yearly: al terminarla se crea la siguiente. |
assignee_ids |
uuid[] | Responsables; reemplaza la lista. |
follower_ids |
uuid[] | Seguidores; reemplaza la lista. |
tags |
string[] | Nombres de etiquetas; las que no existen se crean. |
blocked_by_ids |
uuid[] | Tareas del mismo proyecto que deben terminarse antes. Se rechazan los círculos. |
curl -X POST https://recaudo.app/api/v1/projects/{id}/tasks \
-H "Authorization: Bearer sk_live_tu_secret_key" \
-H "Content-Type: application/json" \
-d '{
"title": "Diseñar piezas para redes",
"assignee_ids": ["uuid-del-usuario"],
"due_date": "2026-12-05",
"priority": "high",
"tags": ["Diseño"]
}'
{
"object": "project_task",
"data": {
"id": "uuid-de-la-tarea",
"project_id": "uuid-del-proyecto",
"section_id": "uuid-de-la-seccion",
"title": "Diseñar piezas para redes",
"status": "todo",
"priority": "high",
"start_date": null,
"due_date": "2026-12-05",
"overdue": false,
"blocked": false,
"assignees": [{"id": "uuid-del-usuario", "name": "María López", "initials": "ML"}],
"tags": [{"id": "uuid-de-etiqueta", "name": "Diseño", "color": "blue"}],
"subtasks": [],
"checklist": [],
"comments": [],
"links": []
}
}
Qué vence y quién lo tiene
GET /v1/project-tasks acepta project_id, assignee_id, status (open = todo lo no terminado), due_before, due_after, overdue=1 e include_subtasks=1.
Avisos
Asignar, mencionar, comentar y terminar avisan a las personas en el panel, por correo y en el celular, igual que desde la pantalla. Quien hace el cambio no recibe aviso.
Ligas con números
type es meta_campaign, landing_page, email_flow, event, lead_form, deal o customer; id es el del elemento (para Meta, el id de la campaña). GET /v1/projects/{id} regresa sus números de los últimos 30 días.
Tareas que se repiten
Al marcar como done una tarea con recurrence, se crea la siguiente con la fecha movida y el checklist sin marcar.
Desde el servidor MCP
Las mismas acciones están como herramientas MCP en la categoría projects: list_projects, get_project, create_project, list_project_tasks, create_project_task, update_project_task, comment_project_task y más.