Recaudo Docs

Marketing

Projetos

Projetos, seções e tarefas: o mesmo que a equipe vê em Lista, Quadro, Calendário e Cronograma.

Crie projetos (em branco ou a partir de um modelo), adicione tarefas com responsáveis, datas, etiquetas e dependências, comente e vincule o projeto a campanhas, páginas ou eventos. Cada mudança avisa a equipe como no painel.

GET /v1/projects Lista projetos com progresso, pendentes e atrasadas. Filtros: status, customer_id, search.
GET /v1/projects/templates Modelos disponíveis (chave, seções e número de tarefas).
POST /v1/projects Cria um projeto, opcionalmente a partir de um modelo.
GET /v1/projects/{id} Projeto com seções, tarefas e o que está vinculado com seus números.
PUT /v1/projects/{id} Altera nome, status, datas, responsável ou cliente.
DELETE /v1/projects/{id} Exclui o projeto e suas tarefas.
POST /v1/projects/{id}/sections Adiciona uma seção (coluna do quadro).
POST /v1/projects/{id}/links Vincula o projeto ou uma tarefa a uma campanha da Meta, página, e-mail, evento, formulário, oportunidade ou cliente.
POST /v1/projects/{id}/tasks Cria uma tarefa ou subtarefa.
GET /v1/project-tasks Tarefas de um projeto ou de todos, com filtros por responsável, status e datas.
GET /v1/project-tasks/{id} Detalhe: subtarefas, checklist, dependências, arquivos, comentários, vínculos e atividade.
PUT /v1/project-tasks/{id} Altera a tarefa; status=done a conclui.
DELETE /v1/project-tasks/{id} Exclui a tarefa e suas subtarefas.
POST /v1/project-tasks/{id}/comments Comenta; @Nome ou @e-mail avisa essa pessoa.
POST /v1/project-tasks/{id}/checklist Adiciona um item ao checklist.

Criar um projeto a partir de um modelo

Com template, as tarefas chegam com seção, prioridade, checklist e datas calculadas a partir de anchor_date (o dia de início, do lançamento ou do evento, conforme o modelo). Modelos: campaign_launch, webinar_event, agency_client e monthly_content.

Exemplo de requisição
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 uma tarefa

Campo Tipo Descrição
title string Título (obrigatório ao criar).
description string Descrição em Markdown.
section_id uuid Seção do projeto; se não for enviada, a primeira.
parent_id uuid Tarefa principal, para criar uma subtarefa.
status string todo, in_progress, review ou done.
priority string low, medium, high ou urgent.
start_date date Data de início (YYYY-MM-DD).
due_date date Data de entrega (YYYY-MM-DD).
recurrence string daily, weekly, biweekly, monthly ou yearly: ao concluí-la, a próxima é criada.
assignee_ids uuid[] Responsáveis; substitui a lista.
follower_ids uuid[] Seguidores; substitui a lista.
tags string[] Nomes de etiquetas; as que não existem são criadas.
blocked_by_ids uuid[] Tarefas do mesmo projeto que precisam terminar antes. Ciclos são rejeitados.
Exemplo de requisição
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"]
  }'
Exemplo de resposta
{
  "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": []
  }
}

O que vence e com quem está

GET /v1/project-tasks aceita project_id, assignee_id, status (open = tudo o que não terminou), due_before, due_after, overdue=1 e include_subtasks=1.

Avisos

Atribuir, mencionar, comentar e concluir avisam as pessoas no painel, por e-mail e no celular, como na tela. Quem faz a mudança não recebe aviso.

Vínculos com números

type é meta_campaign, landing_page, email_flow, event, lead_form, deal ou customer; id é o do item (para a Meta, o id da campanha). GET /v1/projects/{id} devolve seus números dos últimos 30 dias.

Tarefas que se repetem

Ao marcar como done uma tarefa com recurrence, a próxima é criada com a data adiantada e o checklist desmarcado.

Pelo servidor MCP

As mesmas ações estão disponíveis como ferramentas MCP na categoria projects: list_projects, get_project, create_project, list_project_tasks, create_project_task, update_project_task, comment_project_task e mais.

Esta página ajudou? Obrigado por avisar.
Esc