Clickup

Configuration

ClickUp source connector integrates with the ClickUp API to extract and synchronize data.

Connects to your ClickUp workspaces.

It supports syncing workspaces, spaces, folders, lists, tasks, and comments.

Explore the Clickup connector implementation

This connector uses OAuth 2.0 authentication. You can connect through the Airweave UI or API using the OAuth flow.

Supported authentication methods:

This connector does not have any additional configuration options.

The following data models are available for this connector:

Schema for ClickUp workspace entities.

Schema for ClickUp space entities.

Field	Type	Description
space_id	str	Space ID
name	str	Space name
private	bool	Whether the space is private
status	Dict[str, Any]	Space status configuration
multiple_assignees	bool	Whether multiple assignees are allowed
features	Dict[str, Any]	Space features configuration

Schema for ClickUp folder entities.

Schema for ClickUp list entities.

Field	Type	Description
list_id	str	List ID
name	str	List name
folder_id	Optional[str]	Parent folder ID (optional)
space_id	str	Parent space ID
content	Optional[str]	List content/description
status	Optional[Dict[str, Any]]	List status configuration
priority	Optional[Dict[str, Any]]	List priority configuration
assignee	Optional[str]	List assignee username
task_count	Optional[int]	Number of tasks in the list
due_date	Optional[Any]	List due date
start_date	Optional[Any]	List start date
folder_name	Optional[str]	Parent folder name
space_name	str	Parent space name

Schema for ClickUp task entities.

Field	Type	Description
task_id	str	Task ID
name	str	Task name
status	Dict[str, Any]	Task status configuration
priority	Optional[Dict[str, Any]]	Task priority configuration
assignees	List[Dict[str, Any]]	List of task assignees
tags	List[Dict[str, Any]]	List of task tags
due_date	Optional[datetime]	Task due date
start_date	Optional[datetime]	Task start date
time_estimate	Optional[int]	Estimated time in milliseconds
time_spent	Optional[int]	Time spent in milliseconds
custom_fields	List[Dict[str, Any]]	List of custom fields
list_id	str	Parent list ID
folder_id	str	Parent folder ID
space_id	str	Parent space ID
url	str	Task URL
description	Optional[str]	Task description
parent	Optional[str]	Parent task ID if this is a subtask

Schema for ClickUp comment entities.

Field	Type	Description
comment_id	str	Comment ID
task_id	str	Parent task ID
user	Dict[str, Any]	Comment author information
text_content	Optional[str]	Comment text content
resolved	bool	Whether the comment is resolved
assignee	Optional[Dict[str, Any]]	Comment assignee information
assigned_by	Optional[Dict[str, Any]]	User who assigned the comment
reactions	List[Dict[str, Any]]	List of reactions to the comment
date	Optional[datetime]	Comment creation date

Schema for ClickUp subtask entities.

Supports nested subtasks where subtasks can have their own subtasks. The parent_task_id points to the immediate parent (task or subtask).

Field	Type	Description
subtask_id	str	Subtask ID
name	str	Subtask name
parent_task_id	str	Immediate parent task/subtask ID
status	Dict[str, Any]	Subtask status configuration
assignees	List[Dict[str, Any]]	List of subtask assignees
due_date	Optional[datetime]	Subtask due date
description	Optional[str]	Subtask description
nesting_level	Optional[int]	Nesting level (1 = direct subtask, 2 = nested subtask, etc.)

Schema for ClickUp file attachments.

Represents files attached to ClickUp tasks. Reference: https://api.clickup.com/api/v2/task/{task_id}

Field	Type	Description
task_id	str	ID of the task this file is attached to
task_name	str	Name of the task this file is attached to
attachment_id	str	ClickUp attachment ID
version	Optional[int]	Version number of the attachment
date	Optional[datetime]	Date when the attachment was added
title	Optional[str]	Original title/name of the attachment
extension	Optional[str]	File extension
hidden	bool	Whether the attachment is hidden
parent	Optional[str]	Parent attachment ID if applicable
thumbnail_small	Optional[str]	URL for small thumbnail
thumbnail_medium	Optional[str]	URL for medium thumbnail
thumbnail_large	Optional[str]	URL for large thumbnail
is_folder	Optional[bool]	Whether this is a folder attachment
mimetype	Optional[str]	MIME type of the file
total_comments	Optional[int]	Number of comments on this attachment
url	Optional[str]	Direct URL to download the attachment
url_w_query	Optional[str]	URL with query parameters
url_w_host	Optional[str]	URL with host parameters
email_data	Optional[Dict[str, Any]]	Email data if attachment is from email
user	Optional[Dict[str, Any]]	User who uploaded the attachment
resolved	Optional[bool]	Whether the attachment is resolved
resolved_comments	Optional[int]	Number of resolved comments
source	Optional[int]	Source type of the attachment (numeric)
attachment_type	Optional[int]	Type of the attachment (numeric)
orientation	Optional[str]	Image orientation if applicable
parent_id	Optional[str]	Parent task ID
deleted	Optional[bool]	Whether the attachment is deleted
workspace_id	Optional[str]	Workspace ID