Create, read, update, complete and reopen tasks through Todoist API v1.
Explore 8 workflow actions for Todoist, including account permissions and operation limits.
3 read actions5 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Close task
Write
Complete a regular task or advance a recurring task to its next occurrence.
Permissions and limits
Account permissions
data:read_write
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create task
Write
Create a Todoist task in a project or in the connected user's Inbox.
Permissions and limits
Account permissions
task:add
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete task
Write
Delete a task and its subtasks.
Permissions and limits
Account permissions
data:delete
A repeated request may repeat the external action. Review the previous result before retrying a write.
Filter tasks
Read
Read a page of tasks matching a Todoist filter expression.
Permissions and limits
Account permissions
data:read
Operation limits
Returns one page. Continue with next_cursor, the same query and language. Null next_cursor means the final page.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Get task
Read
Read an active Todoist task by ID.
Permissions and limits
Account permissions
data:read
List active tasks
Read
Read a page of active tasks using optional project, section, parent or label filters.
Permissions and limits
Account permissions
data:read
Operation limits
Returns one page. Continue with next_cursor and identical filters; null means the final page.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Reopen task
Write
Restore a task from completion history. Todoist may also reopen its ancestors.
Permissions and limits
Account permissions
data:read_write
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update task
Write
Change task content, description, labels, priority, assignment or due date.
Permissions and limits
Account permissions
data:read_write
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Todoist. A saved workflow is not a completed provider action.