Route
id | todoist.task.v1 |
object_type | task |
delivery_modes | api quickAdd |
Voice examples
- Add a new task to Todoist called complete development docs for 4 PM today
- New Todoist task: send Sarah the proposal tomorrow high priority
API api
automatic_create | Supported |
setup | Pro, Enabled in Settings, Todoist API token |
Writable fields
| Field | Behavior |
|---|
title | Sent as Todoist task content. |
dueDate | Sent as due_date when date-only. |
dueDateTime | Sent as due_datetime when a time is present. |
description | Optional task description. |
priority | Optional priority. high maps to Todoist priority 4; normal/low map to 1. |
Planned / unsupported fields
| Field | Reason |
|---|
labels | Needs configured or fetched label names. |
project | Needs a configured project catalog and ID lookup. |
section | Needs project/section catalog validation. |
Adapter payload
{
"endpoint": "POST https://api.todoist.com/api/v1/tasks",
"body": {
"content": "{title}",
"description": "{description}",
"due_date": "{yyyy-mm-dd}",
"due_datetime": "{ISO-8601 datetime}",
"priority": "{1|4}"
}
}
Quick Add quickAdd
automatic_create | Not supported / requires user confirmation |
setup | Pro, Enabled in Settings, Todoist app installed |
Writable fields
| Field | Behavior |
|---|
title | Sent as Quick Add content. |
dueDate | Sent as natural date text. |
dueDateTime | Sent as natural date/time text. |
priority | Sent when available. |
Planned / unsupported fields
| Field | Reason |
|---|
description | Not currently written through Quick Add. |
labels | Needs safe label handling. |
project | Needs project lookup. |
section | Needs section lookup. |
Adapter payload
{
"url": "todoist://addtask?content={title}&date={date}&priority={priority}"
}
Generated schema summary
{
"id": "todoist.task.v1",
"app": "Todoist",
"object_type": "task",
"delivery_modes": [
"api",
"quickAdd"
],
"writable_fields": [
"title",
"dueDate",
"dueDateTime",
"description",
"priority"
]
}