ClickUp

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

Integrações

Gráfico de relacionamento entre tabelas

Workspaces

Campo	Tipo
id	text
name	text
color	text
avatar	text

Spaces

Objeto principal

Campo	Tipo
space_id	text
workspace_id	text
archived	boolean
multiple_assignees	boolean
name	text
private	boolean

priorities

Campo	Tipo
space_id	text
color	text
priority_id	float
priorities__orderindex	float
priorities__priority	text

statuses

Campo	Tipo
space_id	text
status_id	text
color	text
orderindex	float
status	text
type	text

_features

Campo	Tipo
space_id	text
eature	text
feature_key	text
feature_val	boolean

Folders

Objeto principal

Campo	Tipo
folder_id	text
space_id	text
archived	boolean
hidden	boolean
name	text
orderindex	float
override_statuses	boolean
permission_level	text
task_count	float

statuses

Campo	Tipo
folder_id	text
color	text
status_id	text
orderindex	float
status	text
type	text

Lists

Campo	Tipo
list_id	text
folder_id	text
archived	boolean
due_date	timestamp
name	text
orderindex	float
override_statuses	boolean
permission_level	text
priority__color	text
priority__priority	text
start_date	timestamp
status__color	text
status__hide_label	boolean
status__status	text
task_count	float

Lists members

Campo	Tipo
list_id	text
user_id	text
username	text
email	text
color	text
initials	text
profilepicture	text

Tasks

Objeto principal

Campo	Tipo
task_id	text
workspace_id	text	Workspaces > > id
creator_id	text	List members > > user_id
folder_id	text	Folders > > folder_id
list_id	text	Lists > > list_id
space_id	text	Spaces > > space_id
custom_id	text
date_closed	timestamp
date_done	timestamp
date_created	timestamp
date_updated	timestamp
start_date	timestamp
description	text
due_date	timestamp
name	text
orderindex	float
parent	text
permission_level	text
points	float
archived	boolean
priority_color	text
priority_id	text
priority_orderindex	float
priority_priority	text
status__color	text
status__orderindex	float
status__status	text
status__type	text
text_content	text
time_estimate	float
url	text

clickup_tasks__tags

Campo	Tipo
task_id	text
tag_creator	text	List members > > user_id
tag_name	text
tag_bg	text
tag_fg	text

clickup_tasks__dependencies

Campo	Tipo
task_id	text
dependency_date_created	timestamp
dependency_depends_on	text
dependency_type	float
dependency_userid	text	List members > > user_id

clickup_tasks__assignees

Campo	Tipo
task_id	text
assignee_id	text	List members > > user_id

clickup_tasks__linked_tasks

Campo	Tipo
task_id	text
date_created	timestamp
link_id	text
userid	text	List members > > user_id

Tasks: custom fields

Campo	Tipo
task_id	text
field_x	text
field_y	timestamp
field_z	float

Apenas campos customizados de tarefas de listas que estejam dentro de pastas serão retornados

Tasks: time in status

É necessário que o ClickApp "Total time in Status" tenha sido habilitado

Objeto principal

Campo	Tipo
task_id	text
current_status_name	text
current_status_color	text
current_status_total_time_by_minute	float
current_status_total_time_since	timestamp

status_history

Campo	Tipo
task_id	text
status_name	text
status_color	text
status_type	text
total_time_by_minute	float
total_time_since	timestamp
orderindex	float

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-04-25