---
title: "Quick Add"
method: POST
path: "/api/v1/tasks/quick"
tags: ["Tasks"]
---

# Quick Add

`POST /api/v1/tasks/quick`

Add a new task using Quick Add with natural language processing.

Quick Add allows creating tasks with rich metadata using natural language text.
This endpoint uses the same parsing engine as Todoist's official clients,
supporting dates, projects, labels, priorities, assignees, and more in a single
text string.

## Basic Syntax Overview

- **Due dates**: Natural language like `today`, `tomorrow at 5pm`, `next Monday`
- **Projects**: `#ProjectName` (use `#My\\ Project` for names with spaces)
- **Sections**: `/SectionName` (requires a project to be specified)
- **Labels**: `@labelname` (multiple labels supported)
- **Priority**: `p1` to `p4`, `P1` to `P4`, or `!!1` to `!!4`
- **Assignees**: `+Name` (requires a project to be specified)
- **Deadlines**: `{date expression}` (e.g., `{tomorrow}`, `{in 3 days}`)
- **Reminders**: `!30m` (30 min before), `!1h` (1 hour before), `!0mb` (at due time),
  `!14:00` (absolute time), `!30 min before` (verbose, English only)
- **Descriptions**: ` // description text` (must be at the end)

## Examples

- `"Buy milk today at 5pm #Shopping @groceries p1"`
- `"Team meeting next Monday at 10am #Work +JohnDoe !30m"`
- `"Review PR {Friday} // Check the new authentication flow"`
- `"Submit report tomorrow #Work /Urgent @important // Include Q3 metrics"`

## Important Notes

- Natural language date parsing supports multiple languages based on account settings
- If parsing fails for any element, the task is still created (with unparsed text
  remaining in the content)
- Use the `meta` parameter to see detailed parsing results for debugging

For comprehensive documentation including all supported date formats, language
support, and advanced syntax, see the
[Quick Add help article](https://www.todoist.com/help/articles/use-task-quick-add-in-todoist-va4Lhpzz).

## Request body

- Body40158d1f
  - `text` string, required — The text of the task to parse using Quick Add syntax. See the endpoint description for supported syntax elements.
  - `note` string, nullable — A note to attach to the task. The note content is added as a comment on the created task. If the user's plan does not support comments, this parameter is ignored.
  - `reminder` string, nullable — A reminder date in natural language format, similar to due date parsing. If the user's plan does not support reminders, this parameter is ignored. If the reminder text cannot be parsed, it is silently ignored.
  - `auto_reminder` boolean — When enabled, the default reminder will be added to the new item if it has a due date with time set. See also the [auto_reminder user option](#tag/Sync/User) for more info about the default reminder.
  - `meta` boolean — When enabled, the response includes a `meta` object containing the detailed parsing results. This shows exactly how the Quick Add text was interpreted, including which project, labels, due date, priority, etc. were detected. Useful for debugging parsing behavior or building integrations that need to understand how text was parsed.

## Response `200`

Successful Response

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/todoist/apis/todoist-api.md) · [All operations](https://skmtc.net/todoist/apis/todoist-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/todoist/todoist-api/revisions/69a962f1578f/schema)