Recaudo Docs

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.

Ejemplo de petición
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.
Ejemplo de petición
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"]
  }'
Ejemplo de respuesta
{
  "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.

¿Te sirvió esta página? Gracias por avisarnos.
Esc