Todoist API: what you can do and how to use it with AI agents
The Todoist API lets you create, update and complete tasks and manage projects, sections, labels and comments. People and teams who organize their work in Todoist use it to feed tasks in from other systems. Access is through a personal token, or OAuth for apps.
What the Todoist API offers
Tasks
Creating with due date, priority, assignee and recurrence, plus completing and editing.
Projects and sections
Organizing tasks by project and stage.
Labels
Classifying tasks by context.
Comments
Notes and attachments on tasks and projects.
Sync
Incremental reading of what changed since the last request.
Webhooks
Notices to apps when tasks are created, completed and changed.
How to access the Todoist API
- Public APIA personal token available in the Todoist integration settings, or OAuth 2.0 for published apps.
- A personal token reaches everything in the account, so keep it only in the vault.
- There are request limits, so use incremental sync.
- Tasks can hold sensitive information, so avoid passing them on to other channels.
Official documentation: developer.todoist.com
What an iTeam agent does with the Todoist API
Email that becomes a task
The agent reads requests that arrive by email and creates the task in the right project with a due date and a link to the message.
Daily planning
Every morning, the agent sends today's and overdue tasks on WhatsApp, and reschedules whatever the person asks.
Minutes into action
After the meeting, the decisions become tasks with owners in the shared project.
Weekly review
The agent lists tasks stuck for weeks and asks whether they still matter.
From the credential to the agent at work, with approval
Get the token or authorize through OAuth
Use the account that owns the tasks, or an app with minimal scopes.
Store it in the iTeam vault
The token stays in the vault. The agent creates and completes tasks without deleting projects.
Test with approval
Deletions and changes to shared projects need confirmation.
Ready-made AI teams for this work
Management reporting team
Revenue, margin, pipeline and cash in one report, built from your systems, with a short note on what changed and why.
Inventory planning team
Stock, sales and lead times are checked every day. You get a reorder list per SKU and a warning about what is not selling.
Procurement and quotes team
Requests go out to suppliers, quotes come back into one table, and the approver sees price, terms and past orders before saying yes.
Logistics and deliveries team
Routes, drivers and delivery status in one place, with customers told about delays before they have to ask.
Questions about the Todoist API
Is the Todoist API free?
In general, yes. The API is available with no per-call charge, and some features depend on the account plan.
Do I need to code to use the Todoist API with iTeam?
Not necessarily. Todoist is in the iTeam app catalog, and the deployment team sets up the workflows.
Can I create a task from natural language?
Yes. The API accepts due dates written naturally, and the agent interprets the request before creating the task.
