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

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Due string

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

Priority

Priority 1 (normal/lowest) to 4 (urgent/highest); 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