> For the complete documentation index, see [llms.txt](https://docs.kognitos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kognitos.com/guides/platform/integrations/todoist.md).

# Todoist

Overview of the Todoist integration.

{% hint style="info" %}
The following documentation is for **Todoist v1.0.0**.
{% endhint %}

## Overview

Enables managing tasks, projects, sections, labels, and comments in Todoist.

## Setup

The following integrations need to be connected to your Kognitos workspace:

* **Todoist**

### Steps

Follow these steps to connect the integration in Kognitos:

{% stepper %}
{% step %}

#### Navigate

Using the left navigation menu, go to **Integrations** → **Explore Integrations**.
{% endstep %}

{% step %}

#### Find

Search for the integration and click on it.
{% endstep %}

{% step %}

#### Connect

Click on <kbd>**Connect**</kbd> to add a connection to the integration.
{% endstep %}

{% step %}

#### Configure

Add a name for the connection. You'll be prompted for [**authentication**](#authentication) details if needed. Then, click on <kbd>**Connect**</kbd>.
{% endstep %}
{% endstepper %}

## Authentication

Use one of the following authentication methods to connect this integration in Kognitos. Each method has its own configuration requirements.

#### Connect using API Token

Connect to Todoist using a personal API token.

| Label     | Description                                                                                             | Type        |
| --------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| API Token | Your Todoist personal API token. Find it at Settings > Integrations > Developer in the Todoist web app. | `sensitive` |

#### OAuth Authorization Code

Connect to Todoist using OAuth. Provide the following from your OAuth application:

| Label         | Description             | Type        |
| ------------- | ----------------------- | ----------- |
| Client ID     | OAuth client identifier | `text`      |
| Client Secret | OAuth client secret     | `sensitive` |

## Actions

{% hint style="info" %}
The available actions for **Todoist** are listed in the product UI on the integration page once you create a connection.
{% endhint %}