Todoist CreateTask

Todoist CreateTask

Certified

Create Todoist task

Creates a Todoist task with required content plus optional description, priority, project, and natural-language due date. Uses Todoist API v1; fails on HTTP 4xx/5xx.

yaml
type: io.kestra.plugin.todoist.CreateTask

Create a simple task

yaml
id: todoist_create_task
namespace: company.team

tasks:
  - id: create_task
    type: io.kestra.plugin.todoist.CreateTask
    apiToken: "{{ secret('TODOIST_API_TOKEN') }}"
    content: "Review pull requests"

Create a task with description and priority

yaml
id: todoist_create_urgent_task
namespace: company.team

tasks:
  - id: create_urgent_task
    type: io.kestra.plugin.todoist.CreateTask
    apiToken: "{{ secret('TODOIST_API_TOKEN') }}"
    content: "Deploy to production"
    taskDescription: "Deploy version 2.0 after testing"
    priority: 4
    dueString: "tomorrow"
Properties

Provide Todoist API token

Personal API token sent as Bearer auth to Todoist API v1. Keep it in a Kestra Secret; required for all Todoist tasks.

Task content

Visible task title; required

Due string

Natural-language due date parsed by Todoist (e.g., 'tomorrow', 'next Monday', '2025-12-31')

Reference (ref) of the pluginDefaults to apply to this task.

Priority

Priority 1 (highest) to 4 (lowest); defaults to Todoist standard when omitted

Project ID

Target project ID; leave null for Inbox

Task description

Optional long description

Task ID

The ID of the created task