Todoist

Overview

Todoist’s API manages tasks, projects, and productivity data. Important (verified 2026-08): the legacy REST endpoints under /rest/v2/ return HTTP 410 “This endpoint is deprecated” — Todoist now serves the API under the /api/v1/ prefix. Update integrations accordingly.

Quick Start

Use the new /api/v1/ base (replace YOUR_TOKEN):

curl "https://api.todoist.com/api/v1/tasks" \
  -H "Authorization: Bearer YOUR_TOKEN"

[
  { "id": "12345", "content": "Buy milk", "project_id": "6789", "is_completed": false }
]

Create a task:

curl -X POST "https://api.todoist.com/api/v1/tasks" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "Buy milk"}'

Authentication

• OAuth 2.0 app flow, or a personal token from Todoist settings → Integrations → Developer.
• Send as Authorization: Bearer YOUR_TOKEN.

Rate Limits & Notes

• Migration (verified 2026-08): /rest/v2/... endpoints return 410 Gone with a message pointing to /api/v1/ — use the new prefix (the Sync API v9+ also moved).
• Free tier includes API access; heavy sync usage is rate-limited (check the docs).
• The REST API covers tasks, projects, sections, labels, comments.

FAQ

Is Todoist API free? Yes — API access is included with Todoist accounts (rate-limited).

Why does my old endpoint return 410? Todoist deprecated the /rest/v2/ prefix — use /api/v1/ (verified 2026-08).

How do I get a token? Settings → Integrations → Developer → API token.