Todoist

Configuration

Todoist source connector integrates with the Todoist REST API to extract task data.

Connects to your Todoist workspace.

It provides comprehensive access to projects, tasks, and collaboration features with proper hierarchical organization and productivity insights.

Explore the Todoist 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 Todoist project entities.

Field	Type	Description
name	str	The name of the project
color	Optional[str]	Color of the project (e.g., ‘grey’, ‘blue’)
comment_count	int	Number of comments in the project
order	int	Project order in the project list
is_shared	bool	Whether the project is shared with others
is_favorite	bool	Whether the project is marked as a favorite
is_inbox_project	bool	Whether this is the Inbox project
is_team_inbox	bool	Whether this is the team Inbox project
view_style	Optional[str]	Project view style (‘list’ or ‘board’)
url	Optional[str]	URL to access the project
parent_id	Optional[str]	ID of the parent project if nested

Schema for Todoist section entities.

Field	Type	Description
name	str	The name of the section
project_id	str	ID of the project this section belongs to
order	int	Section order in the project

Schema for Todoist task entities.

Field	Type	Description
content	str	The task content/title
description	Optional[str]	Optional detailed description of the task
comment_count	int	Number of comments on the task
is_completed	bool	Whether the task is completed
labels	List[str]	List of label names attached to the task
order	int	Task order in the project or section
priority	int	Task priority (1-4, 4 is highest)
project_id	Optional[str]	ID of the project this task belongs to
section_id	Optional[str]	ID of the section this task belongs to
parent_id	Optional[str]	ID of the parent task if subtask
creator_id	Optional[str]	ID of the user who created the task
created_at	Optional[datetime]	When the task was created
assignee_id	Optional[str]	ID of the user assigned to the task
assigner_id	Optional[str]	ID of the user who assigned the task
due_date	Optional[str]	Due date in YYYY-MM-DD format
due_datetime	Optional[datetime]	Due date and time
due_string	Optional[str]	Original due date string (e.g., ‘tomorrow’)
due_is_recurring	bool	Whether the task is recurring
due_timezone	Optional[str]	Timezone for the due date
deadline_date	Optional[str]	Deadline date in YYYY-MM-DD format
duration_amount	Optional[int]	Duration amount
duration_unit	Optional[str]	Duration unit (‘minute’ or ‘day’)
url	Optional[str]	URL to access the task

Schema for Todoist comment entities.

Field	Type	Description
task_id	str	ID of the task this comment belongs to
content	Optional[str]	The comment content
posted_at	datetime	When the comment was posted