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.
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. |
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": []
}
}
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.