Skip to main content
O conector ClickUp sincroniza tasks e a estrutura do workspace do ClickUp com a infraestrutura strattum.ai. Os dados aparecem no Data Catalog e alimentam o contexto de trabalho e projetos no Memory e no Knowledge.

​
Capacidades

  • Sincroniza tasks, spaces, lists e membros do workspace.
  • Carga incremental de tasks pela data de atualização (date_updated).
  • Autenticação via API key pessoal do ClickUp.

​
Objetos suportados

​
Pré-requisitos

Conta ClickUp

Acesso a um workspace ClickUp com as tasks que você quer sincronizar.

API key e Team ID

A API key pessoal e o ID do workspace (team). O passo a passo está abaixo.

​
Configuração

1

Gere a API key

No ClickUp, acesse Settings → Apps e copie a API Token pessoal, que começa com pk_.
A API key concede o mesmo acesso do seu usuário. Guarde-a em local seguro e nunca a comite em repositórios.
2

Descubra o Team ID

O Team ID (ID do workspace) aparece na URL do ClickUp: app.clickup.com/{team_id}/.... Copie o número.
3

Adicione o conector no Console

No menu lateral do Console, clique em Conectores → + Nova Conexão e selecione ClickUp. Preencha os campos:
  • Nome do Conector — identificador na lista de conectores (Obrigatório)
  • API Key — token pk_... gerado na etapa anterior (Obrigatório)
  • Team ID — ID numérico do workspace (Obrigatório)
4

Teste e salve

Clique em Testar Conexão para validar as credenciais e, em seguida, em Salvar Conector.

​
Autenticação e escopos

A autenticação é por API key pessoal enviada no header Authorization contra a API v2 do ClickUp. A API key não tem escopos granulares — o acesso é o mesmo do usuário dono da chave.

​
Frequência de sync

O conector sincroniza a cada 15 minutos. A primeira execução após a ativação roda como sample sync (amostra) e, ao concluir, o ciclo completo passa a rodar no schedule padrão.

​
Limitações conhecidas

  • spaces, lists e members são carregados em full refresh a cada ciclo; apenas tasks é incremental.
  • A API key herda o acesso do usuário dono; tasks em spaces sem acesso não são sincronizadas.
  • Tasks deletadas na origem não são removidas automaticamente em modo incremental.
  • Campos customizados são lidos como retornados pela API, sem normalização adicional.

​
Troubleshooting

​
Próximos passos

Guia de desenvolvimento local

Configure o ambiente local completo com Prefect, worker e Docker Compose.

Quickstart — Data Pipelines

Ative conectores via Console strattum.ai sem precisar de ambiente local.