Todoist API changes

1

Todoist has a new, integrated API that supercedes both their previous “REST” and “SYNC” APIs. At the moment, the shipping version of Drafts integrates using these old APIs. The old APIs will be phased out and shut down in early 2026, so I’m working on migrating Drafts’ integrations to use the new API – but wanted to give a heads up to anyone relying on custom Todoist actions that they may want to consider updating to support the new APIs.

Information on migration to the new API is available on Todoist’s site.

This is what I expect so far, based on my review, if you are using Todoist actions:

  • If you use Drafts’ “Todoist” action step in actions, the change will be invisible and those will just keep working.
  • If you are using custom Todoist actions that are scripted, the authors of these actions may need to update them to keep working before the old API shuts down in the Spring.

And what to know if you author Todoist actions:

  • If you scripted actions that use the convenience methods (like “getTasks”, “getProjects”, etc.) provided by Drafts’ Todoist script object, these scripts may need review. The new results objects have changed slightly.
  • If you use scripted actions that use the request method on the Todoist object, you provide a full endpoint URL to the calls, and these will need to be migrated to the endpoints of the new API. They will continue to work as-is until Todoist actually shuts down the old API, but can be migrated now. In most cases that will just mean changing the endpoint URL you pass from the old https://api.todoist.com/rest/v2/ API to the equivalent endpoint under the https://api.todoist.com/api/v1 API, and reviewing the results changes. For the most part, these changes related to the addition of paginated results.

Let me know if you have any questions about these changes.

1 Like
2

Just to add, for any not getting the developer updates from Doist, aforementioned APIs are confirmed as shutting down on February 10, 2026.

Taken from recent comms they issued…

In preparation for the final shutdown of the deprecated APIs, there will be 3 scheduled brownout periods, during which these APIs will be temporarily unavailable.

These will take place at 10:00 and 18:00 UTC on the following dates:

  • Wednesday - January 7, 2026 (for 1 hour)
  • Wednesday - January 21, 2026 (for 2 hours)
  • Wednesday - February 4, 2026 (for 4 hours)

Edit - Just noticed that the day name/dates don’t tally. So no idea on the brownouts!

2nd edit - Had it confirmed by Doist that they published the correct dates but wrong day names. Edited above to Wednesdays.

3

Drafts 49 will be fully compatible with the new Todost API, and will likely be out this week. This means the Drafts “Todoist” action step and most convenience methods for Todoist scripting will be updated. Custom action that directly access the Todoist API may separately need updates separately – but there’s nothing stopping anyone with those actions from migrating them to the new API endpoints, even in the current shipping version of Drafts. The existing authentication processes are all the same and still work.

1 Like