ClickUp

Adicionando a fonte de dados

Adicionando o conector

Baseado na documentações da API do ClickUp

Requisitos

Utilize um usuário com acesso de admin aos Workspaces que serão integrados

Instruções

O ClickUp atualmente possui duas versões, e a forma de obtenção da chave API para o conector diverge um pouco entre elas. Escolha a sua versão do ClickUp para ir à seção correspondente:

Instruções para o ClickUp 2.0
Instruções para o ClickUp 3.0

Instruções para o ClickUp 2.0

1) Faça login na sua conta do ClickUp, clique no ícone do seu perfil na parte inferior esquerda e depois em My Settings

2) Na página de configurações, na barra esquerda, procure por "Apps"

3) Busque pela seção "API Token" e copie o valor encontrado - este é o momento de gerar uma primeira API Token caso ainda não tenha nenhuma

4) Faça login na plataforma da Kondado, vá para a seção de acionar conectores e selecione o conector do ClickUp

5) Dê um nome para o seu conector e, em API Token, cole o valor obtido no passo 3

Agora basta clicar em SALVAR e para começar a receber dados do ClickUp no Data Warehouse ou Data Lake

Instruções para o ClickUp 3.0

1) Faça login na sua conta do ClickUp, clique no seu avatar no canto superior direito da tela, e então em "Settings":

2) Ainda na barra da esquerda, procure pela seção "Apps" e clique nela:

3) Na seção "API Token", clique em "Generate" caso ainda não tenha uma chave API, ou então em "Regenerate", e copie o valor gerado:

4) Faça login na plataforma da Kondado, vá para a seção de acionar conectores e selecione o conector do ClickUp

5) Dê um nome para o seu conector e, em API Token, cole o valor obtido no passo 3

Agora basta clicar em SALVAR e para começar a receber dados do ClickUp no Data Warehouse ou Data Lake

Pipelines

Diagrama de relacionamento

Clique para expandir

Folders

Tipo de replicacao: Integral

Relacionamentos:

space_id → Spaces > space_id

Objeto principal

Pastas utilizadas para agrupar listas dentro de cada espaco.

Campo	Tipo
folder_id	text	[pt] Identificador unico da pasta.
space_id	text	[pt] Espaco ao qual a pasta pertence. Spaces > > space_id
archived	boolean	[pt] Indica se a pasta esta arquivada.
hidden	boolean	[pt] Indica se a pasta fica oculta para usuarios.
name	text	[pt] Nome exibido da pasta.
orderindex	float	[pt] Posicao da pasta na ordenacao.
override_statuses	boolean	[pt] Permite definir status proprios para listas da pasta.
permission_level	text	[pt] Nivel de permissao concedido para acessar a pasta.
task_count	float	[pt] Quantidade total de tarefas registradas na pasta.

clickup_folders__statuses

Status configurados especificamente para listas da pasta.

Campo	Tipo
folder_id	text	[pt] Referencia a pasta de origem.
color	text	[pt] Cor definida para o status.
status_id	text	[pt] Identificador do status associado.
orderindex	float	[pt] Posicao do status dentro da pasta.
status	text	[pt] Nome do status disponivel na pasta.
type	text	[pt] Categoria do status (ex.: open, closed).

List members

Tipo de replicacao: Integral

Relacionamentos:

list_id → Lists > list_id

Membros associados a cada lista do ClickUp.

Campo	Tipo
list_id	text	[pt] Identificador da lista relacionada. Lists > > list_id
user_id	text	[pt] Identificador do usuario membro.
username	text	[pt] Nome de usuario exibido no ClickUp.
email	text	[pt] Endereco de e-mail do membro.
color	text	[pt] Cor usada para representar o membro.
initials	text	[pt] Iniciais mostradas para o membro.
profilepicture	text	[pt] URL da foto de perfil do membro.

Lists

Tipo de replicacao: Integral

Relacionamentos:

folder_id → Folders > folder_id

Listas que estruturam tarefas dentro de pastas ou espacos.

Campo	Tipo
list_id	text	[pt] Identificador unico da lista.
folder_id	text	[pt] Pasta onde a lista esta localizada. Folders > > folder_id
archived	boolean	[pt] Indica se a lista esta arquivada.
due_date	timestamp	[pt] Data limite definida para a lista.
name	text	[pt] Nome exibido da lista.
orderindex	float	[pt] Posicao da lista na ordenacao.
override_statuses	boolean	[pt] Indica se a lista utiliza status proprios.
permission_level	text
priority_color	text	[pt] Cor associada a prioridade padrao da lista.
priority_priority	text	[pt] Rotulo textual da prioridade padrao.
start_date	timestamp	[pt] Data inicial planejada para a lista.
status_color	text	[pt] Cor aplicada ao status principal da lista.
status_hide_label	boolean	[pt] Indica se o rotulo do status principal deve ser oculto.
status__status	text	[pt] Nome do status principal atribuido a lista.
task_count	float	[pt] Quantidade atual de tarefas na lista.

Spaces

Tipo de replicacao: Integral

Relacionamentos:

workspace_id → Workspaces > id

Objeto principal

Espacos organizacionais configurados no ClickUp.

Campo	Tipo
space_id	text	[pt] Identificador unico do espaco.
workspace_id	text	[pt] Workspace ao qual o espaco pertence. Workspaces > > id
archived	boolean	[pt] Indica se o espaco esta arquivado.
multiple_assignees	boolean	[pt] Permite definir mais de um responsavel por tarefa.
name	text	[pt] Nome exibido do espaco.
private	boolean	[pt] Indica se o espaco e privado.

clickup_spaces__priorities

Configuracoes de prioridade disponiveis em cada espaco.

Campo	Tipo
space_id	text	[pt] Referencia ao espaco de origem.
color	text	[pt] Cor exibida para a prioridade.
priority_id	float	[pt] Identificador numerico da prioridade.
priorities__orderindex	float	[pt] Posicao da prioridade na ordenacao.
priorities__priority	text	[pt] Nome ou rotulo da prioridade.

clickup_spaces__statuses

Lista de status padroes definidos para cada espaco.

Campo	Tipo
space_id	text	[pt] Referencia ao espaco de origem.
status_id	text	[pt] Identificador do status configurado.
color	text	[pt] Cor utilizada para representar o status.
orderindex	float	[pt] Posicao do status na ordenacao.
status	text	[pt] Nome do status disponibilizado.
type	text	[pt] Categoria do status (ex.: open, closed).

clickup_spaces___features

Recursos habilitados e suas chaves para cada espaco.

Campo	Tipo
space_id	text	[pt] Referencia ao espaco de origem.
feature	text	[pt] Nome do recurso configurado.
feature_key	text	[pt] Chave tecnica do recurso.
feature_val	boolean	[pt] Indica se o recurso esta ativo.

Tasks

Tipo de replicacao: Incremental

Relacionamentos:

workspace_id → Workspaces > id
creator_id → List members > user_id
folder_id → Folders > folder_id
list_id → Lists > list_id
space_id → Spaces > space_id
tag_creator > tags → List members > user_id
dependency_userid > dependencies → List members > user_id
assignee_id > assignees → List members > user_id
userid > linked_tasks → List members > user_id

Objeto principal

Tarefas gerenciadas no ClickUp com metadados principais.

Campo	Tipo
task_id	text	[pt] Identificador unico da tarefa.
workspace_id	text	[pt] Workspace ao qual a tarefa pertence. Workspaces > > id
creator_id	text	[pt] Usuario que criou a tarefa. List members > > user_id
folder_id	text	[pt] Pasta que agrupa a tarefa. Folders > > folder_id
list_id	text	[pt] Lista onde a tarefa esta registrada. Lists > > list_id
space_id	text	[pt] Espaco relacionado a tarefa. Spaces > > space_id
custom_id	text	[pt] Identificador personalizado configurado para a tarefa.
date_closed	timestamp	[pt] Data em que a tarefa foi encerrada.
date_done	timestamp	[pt] Data em que a tarefa foi marcada como concluida.
date_created	timestamp	[pt] Data de criacao da tarefa.
date_updated	timestamp	[pt] Data da ultima atualizacao da tarefa.
start_date	timestamp	[pt] Data de inicio planejada da tarefa.
description	text	[pt] Descricao textual da tarefa.
due_date	timestamp	[pt] Data limite atribuida a tarefa.
name	text	[pt] Titulo exibido da tarefa.
orderindex	float	[pt] Posicao da tarefa na ordenacao da lista.
parent	text	[pt] Tarefa pai quando a atividade e subtarefa.
permission_level	text	[pt] Nivel de permissao aplicado a tarefa.
points	float	[pt] Pontuacao atribuida a tarefa.
archived	boolean	[pt] Indica se a tarefa foi arquivada.
priority_color	text	[pt] Cor configurada para a prioridade da tarefa.
priority_id	text	[pt] Identificador da prioridade aplicada.
priority_orderindex	float	[pt] Posicao da prioridade entre as configuracoes da equipe.
priority_priority	text	[pt] Nome da prioridade utilizada na tarefa.
status__color	text	[pt] Cor exibida para o status atual da tarefa.
status__orderindex	float	[pt] Posicao do status atual dentro do fluxo.
status__status	text	[pt] Nome do status atual da tarefa.
status__type	text	[pt] Categoria do status atual (ex.: open, closed).
text_content	text	[pt] Conteudo textual consolidado da tarefa.
time_estimate	float	[pt] Tempo estimado para concluir a tarefa (milissegundos).
url	text	[pt] Link direto para acessar a tarefa.

clickup_tasks__tags

Etiquetas aplicadas nas tarefas.

Campo	Tipo
task_id	text	[pt] Referencia da tarefa rotulada.
tag_creator	text	[pt] Usuario que criou a etiqueta. List members > > user_id
tag_name	text	[pt] Nome da etiqueta aplicada.
tag_bg	text	[pt] Cor de fundo configurada para a etiqueta.
tag_fg	text	[pt] Cor do texto exibido na etiqueta.

clickup_tasks__dependencies

Dependencias cadastradas para as tarefas.

Campo	Tipo
task_id	text	[pt] Tarefa que possui a dependencia.
dependency_date_created	timestamp	[pt] Data de criacao da dependencia.
dependency_depends_on	text	[pt] Tarefa ou elemento do qual esta tarefa depende.
dependency_type	float	[pt] Tipo da dependencia (ex.: waiting, blocking).
dependency_userid	text	[pt] Usuario que registrou a dependencia. List members > > user_id

clickup_tasks__assignees

Relacao de responsaveis por tarefa.

Campo	Tipo
task_id	text	[pt] Tarefa a qual o responsavel esta associado.
assignee_id	text	[pt] Usuario designado para a tarefa. List members > > user_id

Campo

Tipo

task_id

text

[pt] Tarefa a qual o responsavel esta associado.

assignee_id

text

[pt] Usuario designado para a tarefa.

List members > > user_id

clickup_tasks__linked_tasks

Relacoes de vinculacao entre tarefas.

Campo	Tipo
task_id	text	[pt] Tarefa principal vinculada.
date_created	timestamp	[pt] Data em que o vinculo foi criado.
link_id	text	[pt] Identificador do relacionamento entre tarefas.
userid	text	[pt] Usuario que criou o vinculo. List members > > user_id

Tasks: custom fields

Tipo de replicacao: Incremental

Relacionamentos:

task_id → Tasks > task_id

Valores de campos customizados por tarefa.

Campo	Tipo
task_id	text	[pt] Tarefa proprietaria dos campos customizados. Tasks > > task_id
field_x	text
field_y	timestamp
field_z	float

Tasks: time in status

Tipo de replicacao: Incremental

Relacionamentos:

task_id → Tasks > task_id

Objeto principal

Medidas de tempo no status atual para cada tarefa.

Campo	Tipo
task_id	text	[pt] Tarefa analisada para tempo em status. Tasks > > task_id
current_status_name	text	[pt] Nome do status atual.
current_status_color	text	[pt] Cor configurada para o status atual.
current_status_total_time_by_minute	float	[pt] Tempo acumulado no status atual em minutos.
current_status_total_time_since	timestamp	[pt] Inicio do periodo atual no status.

clickup_tasks_time_in_status_history

Historico de tempos por status para cada tarefa.

Campo	Tipo
task_id	text	[pt] Tarefa a que o registro historico se refere.
status_name	text	[pt] Status historico analisado.
status_color	text	[pt] Cor utilizada naquele status historico.
status_type	text	[pt] Categoria do status historico.
total_time_by_minute	float	[pt] Tempo acumulado naquele status em minutos.
total_time_since	timestamp	[pt] Inicio do periodo historico analisado.
orderindex	float	[pt] Ordem do registro dentro da trilha historica.

Workspaces

Tipo de replicacao: Integral

Workspaces disponiveis na conta ClickUp.

Campo	Tipo
id	text	[pt] Identificador unico do workspace.
name	text	[pt] Nome exibido para o workspace.
color	text	[pt] Cor configurada para identificar o workspace.
avatar	text	[pt] Imagem ou avatar associado ao workspace.

Notas

Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

Conectar o ClickUp à Kondado

Siga os passos para integrar seus dados do ClickUp a um Data Warehouse ou Data Lake usando o conector da Kondado.

Verifique os requisitos de acesso

Certifique-se de que o usuário do ClickUp possui acesso de administrador aos Workspaces que serão integrados. Você pode consultar todos os conectores disponíveis na plataforma.

Identifique sua versão do ClickUp

O ClickUp possui duas versões (2.0 e 3.0) e o processo de obtenção da API Token é diferente entre elas. Identifique qual versão você utiliza antes de prosseguir.

Gere a API Token na versão 2.0 ou 3.0

Para o ClickUp 2.0: acesse My Settings pelo ícone do perfil, vá em Apps e copie ou gere a API Token. Para o 3.0: clique no avatar superior direito, acesse Settings > Apps, e clique em Generate ou Regenerate para obter a chave.

Configure o conector na Kondado

Faça login na plataforma da Kondado, vá para a seção de adicionar conectores e selecione o conector do ClickUp. Dê um nome ao conector e cole a API Token obtida.

Salve e comece a receber dados

Clique em SALVAR para finalizar. Seus dados do ClickUp (Workspaces, Spaces, Folders, Lists, Tasks e campos customizados) começarão a ser enviados ao seu Data Warehouse ou Data Lake.

Perguntas frequentes

Qual a diferença entre conectar o ClickUp 2.0 e o 3.0 na Kondado?▼

A diferença está apenas no caminho para obter a API Token dentro do ClickUp. No 2.0, você acessa My Settings pelo ícone do perfil na parte inferior esquerda. No 3.0, clica no avatar no canto superior direito e vai em Settings. A configuração do conector na plataforma Kondado é idêntica para ambas as versões.

Quais dados do ClickUp são extraídos pelo conector?▼

O conector extrai dados de Workspaces, Spaces (com priorities, statuses e features), Folders, Lists (com members), Tasks (com tags, dependencies, assignees, linked tasks, custom fields e time in status), além do histórico de status. Apenas campos customizados de tarefas em listas dentro de pastas são retornados.

É necessário habilitar algum recurso no ClickUp para obter dados de tempo em status?▼

Sim. Para que os dados de "time in status" sejam extraídos, é necessário que o ClickApp "Total time in Status" tenha sido previamente habilitado no seu workspace do ClickUp.

Posso enviar os dados do ClickUp para diferentes destinos?▼

Sim. Após configurar o conector, você pode enviar os dados do ClickUp para diversos destinos suportados pela Kondado, como Data Warehouses, Data Lakes, BI tools e planilhas.

Quais são os requisitos de permissão para integrar o ClickUp?▼

Você precisa utilizar um usuário do ClickUp que tenha acesso de administrador (admin) aos Workspaces que deseja integrar. Sem essa permissão, a API Token gerada não terá acesso aos dados necessários.

Escrito por

Thassyo Pereira·Publicado em 2021-11-03·Atualizado em 2026-06-01