# Todoist integrations: tasks, projects and sections

> Create a task, create a project and create a section in Todoist, and start a workflow when Todoist sends “Task added”.

**Canonical page:** https://tray.ai/connectors/todoist-integrations/
**Categories:** Operations
**Connects through:** HTTP Connector

## Overview

Todoist is a task manager for individuals and teams, organising to-dos into projects and sections with due dates, labels, comments and reminders. Tray.ai connects to Todoist through the HTTP Connector, so your workflows can call the Todoist API alongside the rest of your stack.

## Use cases

### Tasks

Read, create, update, and delete tasks in Todoist from any Tray.ai workflow. The Todoist API covers calls such as list tasks and create a task.

- List tasks
- Create a task
- Update a task

### Projects

Read, create, update, and delete projects in Todoist from any Tray.ai workflow. The Todoist API covers calls such as list projects and create a project.

- List projects
- Create a project
- Update a project

### Sections

Read, create, update, and delete sections in Todoist from any Tray.ai workflow. The Todoist API covers calls such as list sections and create a section.

- List sections
- Create a section
- Update a section

### Comments

Read, create, update, and delete comments in Todoist from any Tray.ai workflow. The Todoist API covers calls such as list comments and create a comment.

- List comments
- Create a comment
- Update a comment

### Labels

Read, create, update, and delete labels in Todoist from any Tray.ai workflow. The Todoist API covers calls such as list labels and create a label.

- List labels
- Create a label
- Update a label

### Todoist events

Start a Tray.ai workflow the moment something happens in Todoist. Todoist sends events such as task added and task updated to a Tray.ai webhook trigger.

- Task added
- Task updated
- Task completed

## Challenges Tray.ai solves

### Keeping Todoist credentials out of logs

A raw API call usually means pasting a key or token into the request, where it ends up in step inputs, logs, and screenshots.

**How Tray.ai helps:** Store Todoist credentials once as a Tray.ai authentication and reference them from the HTTP Connector. Tray.ai masks authentication values in logs, so the secret never shows up in a step's input or output.

### Going from the Todoist API docs to a working call

Translating an example request from API docs into a workflow step means copying the method, URL, headers, and body by hand.

**How Tray.ai helps:** Paste a cURL example from the Todoist API docs into the HTTP Connector and Tray.ai fills in the method, URL, headers, and body for you.

### Handling files and non-JSON responses

Not every API answers in JSON. Some return XML, files, or binary data, or expect a multipart upload.

**How Tray.ai helps:** The HTTP Connector parses JSON and XML responses, returns files you can pass to the next step, and sends multipart form data for uploads.

## Frequently asked questions

### Does Tray.ai connect to Todoist?

Yes. Tray.ai connects to Todoist through the HTTP Connector, which calls the Todoist API directly. Any call the Todoist API documents can run as a step in a Tray.ai workflow.

### How does Tray.ai authenticate with Todoist?

The Todoist API uses a bearer token and OAuth 2.0. You save it once as a Tray.ai authentication, and the HTTP Connector adds it to every request.

### Can I get a dedicated Todoist connector?

Todoist runs through the HTTP Connector rather than a dedicated connector. If your team wants one, the Tray.ai connector SDK can build a dedicated Todoist connector from the Todoist API.

## Learn more

- Intelligent Integration: https://tray.ai/platform/intelligent-ipaas/
- Merlin Agent Builder: https://tray.ai/platform/merlin-agent-builder/
- Agent Gateway for MCP: https://tray.ai/platform/agent-gateway/
- Book a demo: https://tray.ai/contact/
