Todoist website screenshot

Todoist

Todoist is a productivity platform providing task management APIs for developers. The Todoist API v1 unifies the Sync and REST APIs into a single interface, offering programmatic access to tasks, projects, sections, labels, reminders, comments, workspaces, and webhooks. SDKs are available in Python and TypeScript.

Todoist publishes 10 APIs on the APIs.io network, including Sync API v9, Comments API, Labels API, and 7 more. Tagged areas include Productivity, Tasks, To-Do, Task Management, and Collaboration.

The Todoist catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Todoist’s developer surface includes authentication, documentation, signup flow, engineering blog, pricing, and 18 more developer resources.

🌐 Visit website 📡 Source on GitHub
65.4/100 strong ▬ flat Agent 36/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessPaidSelf serve
11 APIs
ProductivityTasksTo-DoTask ManagementCollaboration

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 65.4/100 · strong
Contract Quality 18.5 / 25
Developer Ergonomics 8.3 / 20
Commercial Clarity 18.4 / 20
Operational Transparency 5.8 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 36/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/todoist: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 11

Individual APIs this provider publishes, each with its own machine-readable definition.

Todoist REST API v2

The Todoist REST API v2 is the legacy recommended API for external integrations, providing access to tasks, projects, sections, labels, comments, and filters. Uses Bearer token ...

Todoist Sync API v9

The Todoist Sync API is designed for clients maintaining a local representation of user data, allowing incremental synchronization of projects, tasks, labels, filters, and remin...

Todoist Comments API

Comment and note operations

Todoist Labels API

Label management operations

Todoist Projects API

Project management operations

Todoist Reminders API

Reminder management operations

Todoist Sections API

Section management operations

Todoist Sync API

Incremental sync operations

Todoist Tasks API

Task (item) management operations

Todoist User API

User account and settings operations

Todoist Workspaces API

Workspace management operations

Scroll for all 11

Postman Collections 9

Ready-to-run Postman collections for exercising this provider's APIs.

Todoist Comments API

POSTMAN

Todoist Comments Labels API

POSTMAN

Todoist Comments Projects API

POSTMAN

Todoist Comments Reminders API

POSTMAN

Todoist Comments Sections API

POSTMAN

Todoist Comments Sync API

POSTMAN

Todoist Comments Tasks API

POSTMAN

Todoist Comments User API

POSTMAN

Todoist Comments Workspaces API

POSTMAN

Scroll for all 9

Open Collections 2

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Todoist Webhooks

OPEN COLLECTION

Todoist API

OPEN COLLECTION

GraphQL 1

GraphQL schemas published by this provider.

Todoist GraphQL

Todoist does not expose a native public GraphQL API. The platform is served

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Todoist Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Todoist Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Todoist Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Todoist Context

21 classes · 7 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Todoist API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Todoist API Rules

10 rules · 4 errors 6 warnings

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

Todoist Project

12 properties

JSON SCHEMA

Todoist Task

18 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Todoist Task Structure

0 properties

JSON STRUCTURE

Examples 3

Example request and response payloads for these APIs.

Todoist Create Project Example

2 fields

EXAMPLE

Todoist Create Task Example

2 fields

EXAMPLE

Todoist List Tasks Example

2 fields

EXAMPLE

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Todoist Authentication

http · 1 scheme

SECURITY

Todoist Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Todoist Vulnerability Disclosure

security.txt · contact published

SECURITY

Todoist Trust Center

GDPR

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Todoist Agentic Access

41 operations · 23 acting

41 operations · 23 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 Signup
Signup
 Login
Login

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 MCP Server
MCP Server

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

Webhooks
Webhooks

Build 5

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace
PostmanWorkspace
 SDKs
SDKs
 Python SDK
Python SDK
 TypeScript SDK
TypeScript SDK
 GitHubOrganization
GitHubOrganization

Access & Security 5

Authentication, authorization, and security posture

TrustCenter
TrustCenter
 VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 Authentication
Authentication
 Authentication
Authentication

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 3

The organization behind the API

LinkedIn
LinkedIn
 Website
Website
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: todoist
name: Todoist
description: Todoist is a productivity platform providing task management APIs for developers. The Todoist API v1 unifies
  the Sync and REST APIs into a single interface, offering programmatic access to tasks, projects, sections, labels, reminders,
  comments, workspaces, and webhooks. SDKs are available in Python and TypeScript.
type: Index
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/todoist.png
tags:
- Productivity
- Tasks
- To-Do
- Task Management
- Collaboration
created: '2025-01-08'
modified: '2026-05-30'
url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: todoist:todoist-rest-api
  name: Todoist REST API v2
  description: The Todoist REST API v2 is the legacy recommended API for external integrations, providing access to tasks,
    projects, sections, labels, comments, and filters. Uses Bearer token authentication with OAuth 2.0 support.
  humanURL: https://developer.todoist.com/rest/v2/
  baseURL: https://api.todoist.com/rest/v2
  tags:
  - Productivity
  - Tasks
  - REST
  properties:
  - type: Documentation
    url: https://developer.todoist.com/rest/v2/
- aid: todoist:todoist-sync-api
  name: Todoist Sync API v9
  description: The Todoist Sync API is designed for clients maintaining a local representation of user data, allowing incremental
    synchronization of projects, tasks, labels, filters, and reminders. Supports batch commands for efficient updates.
  humanURL: https://developer.todoist.com/sync/v9/
  baseURL: https://api.todoist.com/sync/v9
  tags:
  - Sync
  - Productivity
  - Tasks
  properties:
  - type: Documentation
    url: https://developer.todoist.com/sync/v9/
  - type: Reference
    url: https://developer.todoist.com/sync/v9/
- aid: todoist:todoist-comments-api
  name: Todoist Comments API
  description: Comment and note operations
  humanURL: https://developer.todoist.com/api/v1/
  baseURL: https://api.todoist.com/api/v1
  tags:
  - Comments
  properties:
  - type: OpenAPI
    url: openapi/todoist-comments-api-openapi.yml
  - type: Documentation
    url: https://developer.todoist.com/api/v1/
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/openapi/todoist-asyncapi.yml
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/json-schema/todoist-task-schema.json
  - type: SpectralRules
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/rules/todoist-rules.yml
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/vocabulary/todoist-vocabulary.yml
  - type: GraphQL
    url: graphql/todoist-graphql.md
- aid: todoist:todoist-labels-api
  name: Todoist Labels API
  description: Label management operations
  humanURL: https://developer.todoist.com/api/v1/
  baseURL: https://api.todoist.com/api/v1
  tags:
  - Labels
  properties:
  - type: OpenAPI
    url: openapi/todoist-labels-api-openapi.yml
  - type: Documentation
    url: https://developer.todoist.com/api/v1/
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/openapi/todoist-asyncapi.yml
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/json-schema/todoist-task-schema.json
  - type: SpectralRules
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/rules/todoist-rules.yml
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/vocabulary/todoist-vocabulary.yml
  - type: GraphQL
    url: graphql/todoist-graphql.md
- aid: todoist:todoist-projects-api
  name: Todoist Projects API
  description: Project management operations
  humanURL: https://developer.todoist.com/api/v1/
  baseURL: https://api.todoist.com/api/v1
  tags:
  - Projects
  properties:
  - type: OpenAPI
    url: openapi/todoist-projects-api-openapi.yml
  - type: Documentation
    url: https://developer.todoist.com/api/v1/
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/openapi/todoist-asyncapi.yml
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/json-schema/todoist-task-schema.json
  - type: SpectralRules
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/rules/todoist-rules.yml
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/vocabulary/todoist-vocabulary.yml
  - type: GraphQL
    url: graphql/todoist-graphql.md
- aid: todoist:todoist-reminders-api
  name: Todoist Reminders API
  description: Reminder management operations
  humanURL: https://developer.todoist.com/api/v1/
  baseURL: https://api.todoist.com/api/v1
  tags:
  - Reminders
  properties:
  - type: OpenAPI
    url: openapi/todoist-reminders-api-openapi.yml
  - type: Documentation
    url: https://developer.todoist.com/api/v1/
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/openapi/todoist-asyncapi.yml
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/json-schema/todoist-task-schema.json
  - type: SpectralRules
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/rules/todoist-rules.yml
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/vocabulary/todoist-vocabulary.yml
  - type: GraphQL
    url: graphql/todoist-graphql.md
- aid: todoist:todoist-sections-api
  name: Todoist Sections API
  description: Section management operations
  humanURL: https://developer.todoist.com/api/v1/
  baseURL: https://api.todoist.com/api/v1
  tags:
  - Sections
  properties:
  - type: OpenAPI
    url: openapi/todoist-sections-api-openapi.yml
  - type: Documentation
    url: https://developer.todoist.com/api/v1/
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/openapi/todoist-asyncapi.yml
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/json-schema/todoist-task-schema.json
  - type: SpectralRules
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/rules/todoist-rules.yml
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/vocabulary/todoist-vocabulary.yml
  - type: GraphQL
    url: graphql/todoist-graphql.md
- aid: todoist:todoist-sync-api
  name: Todoist Sync API
  description: Incremental sync operations
  humanURL: https://developer.todoist.com/api/v1/
  baseURL: https://api.todoist.com/api/v1
  tags:
  - Sync
  properties:
  - type: OpenAPI
    url: openapi/todoist-sync-api-openapi.yml
  - type: Documentation
    url: https://developer.todoist.com/api/v1/
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/openapi/todoist-asyncapi.yml
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/json-schema/todoist-task-schema.json
  - type: SpectralRules
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/rules/todoist-rules.yml
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/vocabulary/todoist-vocabulary.yml
  - type: GraphQL
    url: graphql/todoist-graphql.md
- aid: todoist:todoist-tasks-api
  name: Todoist Tasks API
  description: Task (item) management operations
  humanURL: https://developer.todoist.com/api/v1/
  baseURL: https://api.todoist.com/api/v1
  tags:
  - Tasks
  properties:
  - type: OpenAPI
    url: openapi/todoist-tasks-api-openapi.yml
  - type: Documentation
    url: https://developer.todoist.com/api/v1/
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/openapi/todoist-asyncapi.yml
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/json-schema/todoist-task-schema.json
  - type: SpectralRules
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/rules/todoist-rules.yml
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/vocabulary/todoist-vocabulary.yml
  - type: GraphQL
    url: graphql/todoist-graphql.md
- aid: todoist:todoist-user-api
  name: Todoist User API
  description: User account and settings operations
  humanURL: https://developer.todoist.com/api/v1/
  baseURL: https://api.todoist.com/api/v1
  tags:
  - User
  properties:
  - type: OpenAPI
    url: openapi/todoist-user-api-openapi.yml
  - type: Documentation
    url: https://developer.todoist.com/api/v1/
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/openapi/todoist-asyncapi.yml
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/json-schema/todoist-task-schema.json
  - type: SpectralRules
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/rules/todoist-rules.yml
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/vocabulary/todoist-vocabulary.yml
  - type: GraphQL
    url: graphql/todoist-graphql.md
- aid: todoist:todoist-workspaces-api
  name: Todoist Workspaces API
  description: Workspace management operations
  humanURL: https://developer.todoist.com/api/v1/
  baseURL: https://api.todoist.com/api/v1
  tags:
  - Workspaces
  properties:
  - type: OpenAPI
    url: openapi/todoist-workspaces-api-openapi.yml
  - type: Documentation
    url: https://developer.todoist.com/api/v1/
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/openapi/todoist-asyncapi.yml
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/json-schema/todoist-task-schema.json
  - type: SpectralRules
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/rules/todoist-rules.yml
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/todoist/refs/heads/main/vocabulary/todoist-vocabulary.yml
  - type: GraphQL
    url: graphql/todoist-graphql.md
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/todoist/overview
- type: AgenticAccess
  url: agentic-access/todoist-agentic-access.yml
- type: TrustCenter
  url: security/todoist-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/todoist-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/todoist-domain-security.yml
- type: Authentication
  url: authentication/todoist-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/doist
- type: Website
  url: https://todoist.com/
- type: DeveloperPortal
  url: https://developer.todoist.com/
- type: Documentation
  url: https://developer.todoist.com/api/v1/
- type: Signup
  url: https://todoist.com/users/showregister
- type: Login
  url: https://todoist.com/auth/login
- type: Authentication
  url: https://developer.todoist.com/guides/#oauth
- type: Webhooks
  url: https://developer.todoist.com/api/v1/#webhooks
- type: SDKs
  url: https://developer.todoist.com/guides/#sdks
- type: Python SDK
  url: https://github.com/Doist/todoist-api-python
- type: TypeScript SDK
  url: https://github.com/Doist/todoist-sdk-typescript
- type: MCP Server
  url: https://github.com/doist/todoist-ai
- type: GitHubOrganization
  url: https://github.com/Doist
- type: Blog
  url: https://doist.com/blog/
- type: Pricing
  url: https://todoist.com/pricing
- type: TermsOfService
  url: https://doist.com/terms-of-service
- type: PrivacyPolicy
  url: https://doist.com/privacy-policy
- type: Integrations
  url: https://www.todoist.com/integrations
integrations:
- name: Outlook Mail
- name: Task Assist
- name: Google Calendar
- name: safari
- name: Microsoft-Outlook-icon
- name: integration-logo-trello
- name: Slack
- name: integration-logo-jira-1
- name: 826px-Microsoft Office Teams (2018–present).svg
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com