Base de Conhecimento

ClickUp no n8n: automatize tarefas e listas

  • clickup, n8n, tarefas, webhook, automação, gerenciamento de projetos
  • Usuários acharam útil: 0

Gere o token, crie a credencial, abra tarefas em listas com ou sem pasta, ative o ClickUp Trigger com URL pública em HTTPS e veja o limite de requisições do ClickUp.

Por Redação Eleven Host · @robson.direitodigital · 17 de novembro de 2026 · 8 min de leitura

Arte da Eleven Host: janela de terminal com o título: ClickUp no n8n: automatize tarefas e listas

Capa da Redação Eleven Host para o guia: ClickUp no n8n: automatize tarefas e listas Arte: Eleven Host

Usar clickup no n8n é ligar o gerenciador de tarefas aos seus fluxos: o nó ClickUp cria e atualiza tarefas, listas, comentários e horas, e o ClickUp Trigger avisa o n8n quando algo muda no Workspace.

O ClickUp Trigger confere a assinatura de cada aviso que chega e precisa do n8n acessível pela internet, de preferência em HTTPS.

Atualizado em 17/11/2026. Em 17/11/2026, a versão estável do n8n é a 2.48.4, publicada em 13/11/2026. Nela, o nó ClickUp tem a versão 1.1 como padrão. O n8n marca o nó e o gatilho como (Beta) na descrição.

O que são o nó ClickUp e o ClickUp Trigger

O nó ClickUp consome a API do ClickUp. No campo Resource, o padrão é Task, e as opções são Checklist, Checklist Item, Comment, Folder, Goal, Goal Key Result, List, Space Tag, Task, Task Dependency, Task List, Task Tag, Time Entry e Time Entry Tag. O recurso Task tem as operações Create, Delete, Get, Get Many, Member, Set Custom Field e Update, e o padrão é Create.

O ClickUp Trigger começa o fluxo quando o ClickUp avisa que algo aconteceu. Você escolhe o Team e os Events, e o n8n cuida do resto. Para o que o nó não faz, dá para chamar a API do ClickUp pelo nó HTTP Request, reaproveitando a credencial.

Para quem serve

Serve para a equipe que organiza o trabalho no ClickUp e quer tirar o serviço braçal da frente: transformar um pedido de formulário em tarefa, avisar a equipe quando uma tarefa muda de status e juntar um resumo semanal. Se o n8n fica numa VPS própria, vale conhecer o básico de servidor no artigo sobre servidor VPS.

Sobre servidores, a Eleven Host vende VPS. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Abrir a loja

Passo 1: gerar o token pessoal

No ClickUp 3.0, abra o avatar no canto superior direito, vá em Settings e depois em Apps, na lateral. Em API Token, clique em Generate (ou em Regenerate, se já existe um). O token pessoal começa com pk_ e não expira.

No n8n, crie a credencial ClickUp API, que tem um único campo, o Access Token, e cole o token ali. O n8n manda esse valor no cabeçalho de autorização sem a palavra Bearer. No nó, o campo Authentication já vem em Access Token. Recomendamos tratar o token como senha: ele age com as permissões de quem o gerou.

Passo 2: OAuth2, se preferir

Para uma pequena empresa com um só Workspace, recomendamos o Access Token, que é o caminho mais simples. O OAuth2 combina melhor quando cada pessoa deve conectar a própria conta ou quando não se quer o token pessoal de alguém guardado no n8n. No campo Authentication, a opção é OAuth2, com a credencial ClickUp OAuth2 API.

Só o dono ou um admin do Workspace cria um app OAuth. No n8n instalado por você, siga esta ordem: abra a credencial e copie a OAuth Redirect URL. Depois, no ClickUp, vá em Settings > Apps > Create new app, dê um nome e cole essa URL no campo Redirect URL. O ClickUp entrega o client_id e o secret, que vão para Client ID e Client Secret da credencial. Por fim, clique em Connect my account. O ClickUp avisa que redirecionamentos sem SSL podem deixar de funcionar, então use HTTPS, e informa que o token OAuth hoje não expira, o que está sujeito a mudança.

Passo 3: criar uma tarefa

Crie um workflow com gatilho manual e um nó ClickUp, escolha a credencial e deixe Resource em Task e Operation em Create. Os campos obrigatórios aparecem nesta ordem: Team Name or ID, Space Name or ID, Folderless List, Folder Name or ID, List Name or ID e Name. O Team do n8n corresponde ao Workspace do ClickUp, porque o rótulo segue o nome da API.

Se a lista não está dentro de uma pasta, ligue a chave Folderless List, que vem desligada. Com ela ligada, o campo Folder some e o campo List mostra as listas sem pasta do Space. Com ela desligada, você escolhe a pasta e depois a lista dentro dela. O campo Name recebe o nome da tarefa.

Campos adicionais da tarefa

Em Additional Fields, a criação aceita Assignee Names or IDs, Content, Due Date, Due Date Time, Start Date, Start Date Time, Priority, Status Name or ID, Tag Names or IDs, Time Estimate, Notify All, Is Markdown Content, Custom Fields JSON e Parent ID, que transforma a tarefa em subtarefa.

Passo 4: outras operações úteis

Em Task > Get Many, os campos de Team, Space, Folderless List, Folder e List são os mesmos. O campo Return All vem ligado e, com ele desligado, o Limit tem padrão 50. Em Filters, há Archived, Include Closed, Order By, Subtasks e os intervalos de datas de criação, atualização e vencimento, entre outros.

Outros recursos seguem o mesmo desenho. List tem Create, Custom Fields, Delete, Get, Get Many, Member e Update, e a criação pede Team, Space, Folderless List, Folder (quando não é sem pasta) e Name. Comment tem Create, Delete, Get Many e Update. Checklist tem Create, Delete e Update. Time Entry tem Create, Delete, Get, Get Many, Start, Stop e Update.

Passo 5: receber avisos com o ClickUp Trigger

No ClickUp Trigger, escolha a credencial, o Team Name or ID e, em Events, um ou mais eventos. Entre eles estão task.created, task.updated, task.status.updated e task.comment.posted, além de * para todos. A lista do editor inclui ainda eventos de pasta, meta, lista e Space. Nos Filters opcionais, informe Folder ID, List ID, Space ID ou Task ID para não receber o Workspace inteiro.

Você não cadastra webhook à mão no ClickUp: ao ativar o fluxo, o n8n registra o webhook sozinho e o remove quando o fluxo é desativado. Cada aviso chega com o cabeçalho X-Signature, um HMAC SHA-256 do corpo em hexadecimal, e o n8n recalcula e compara. Se a assinatura não bater, o evento é ignorado e o fluxo não dispara.

Como o ClickUp precisa alcançar o seu n8n, a instalação precisa de uma URL pública, que deve estar pronta antes de você ativar o fluxo. Com proxy reverso, domínio próprio e HTTPS, recomendamos definir N8N_WEBHOOK_URL com o endereço público, como https://n8n.exemplo.com/. A variável antiga WEBHOOK_URL está obsoleta desde o n8n 2.35.0: ainda funciona, mas gera aviso na inicialização. Se a URL estiver errada, por exemplo apontando para localhost, o ClickUp não entrega os avisos.

O teste com Listen for test event usa a URL de teste. Para receber avisos de verdade, deixe o fluxo ativo.

O ClickUp considera falha a resposta com código de erro ou que passe de 7 segundos, e tenta reenviar até 5 vezes por evento. Ao chegar a 100 falhas ele fica suspenso e para de enviar. Reativar exige uma chamada à API do ClickUp. Se o n8n ficar fora do ar por muito tempo, recomendamos desativar e reativar o fluxo, que deve recriar o webhook.

Limites de requisição

Segundo o ClickUp, o limite é contado por minuto e por token. Nos planos Free Forever, Unlimited e Business, são 100 requisições por minuto. No Business Plus, são 1.000, e no Enterprise, 10.000. Ao passar disso, a API devolve o código HTTP 429, com os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset.

O nó ClickUp não trata o 429 e não tenta de novo: o erro aparece no próprio nó. Recomendamos, em fluxos com muitos itens, um nó Loop Over Items para trabalhar em lotes, com um nó Wait entre eles.

Combinações para começar

Um exemplo: formulário vira tarefa. Um Form Trigger do n8n ou um Webhook do site recebe o pedido, e Task > Create abre a tarefa na lista Comercial, com o nome do contato em Name, a mensagem em Content, o vencimento em Due Date e um responsável em Assignee Names or IDs. Para outro quadro de tarefas, veja Trello no n8n: automatize cartões e quadros.

Um exemplo: tarefa concluída avisa a equipe. O ClickUp Trigger, com o evento task.status.updated e o Filter List ID da lista certa, alimenta um nó IF que confere se o status é o de concluído, e a mensagem segue por e-mail ou chat. Para a parte comercial, veja Pipedrive no n8n: automatize negócios do CRM.

Um exemplo: relatório semanal. Um Schedule Trigger na segunda de manhã chama Task > Get Many com Include Closed desligado, e um nó resume a lista para enviar por e-mail.

Problemas comuns

  • Campo Folder sumiu: a chave Folderless List está ligada;
  • O aviso não chega: confira se o fluxo está ativo e se a URL pública, em HTTPS, está certa;
  • Os avisos pararam: o webhook pode ter chegado a 100 falhas, então desative e reative o fluxo;
  • Erro 429: o limite por minuto foi atingido, e o nó não refaz a chamada;
  • Não consegue criar o app OAuth: só o dono ou um admin do Workspace pode;
  • Operação que o nó não tem: use o HTTP Request com a credencial do ClickUp.

Onde o n8n fica no ar

O n8n roda em algum servidor, e a escolha desse servidor é uma decisão à parte dos fluxos.

A Eleven Host oferece VPS em plano mensal. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver planos

Perguntas frequentes

O n8n tem nó do ClickUp?

Sim. Há o nó ClickUp, na versão padrão 1.1, e o ClickUp Trigger. Os dois aparecem com a marca (Beta) na descrição.

Preciso cadastrar o webhook no ClickUp?

Não. O ClickUp Trigger registra o webhook sozinho quando o fluxo é ativado e o remove quando é desativado.

O nó repete a chamada depois de um erro 429?

Não. O nó apenas repassa o erro, então espaçar as chamadas em lotes fica por sua conta.

Esta resposta lhe foi útil?

Artigos Relacionados