View as Markdown
Todoist icon

Todoist ACTION

Create Task

Creates a task. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Todoist account once, then configure and run Create Task from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "todoist-create-task",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    todoist: { authProvisionId: "apn_xxxxxxx" },
    content: "Content",
    description: "Description",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Task inputs
Property Type Description
content Content string
Task Content
Required
description Description string
Task description
Optional
project Project string
Task project. If not set, task is put to user's Inbox.
Optional Dynamic
section Section string
The section to put task into
Optional Dynamic
parent Parent string
Parent task
Optional Dynamic
order Order integer
Order in a list
Optional
labels Labels string[]
Select labels to add to the task.
Optional Dynamic
priority Priority integer
Task priority from 1 (normal) to 4 (urgent)
Optional
dueString Due String string
Human defined task due date (ex.: "next Monday", "Tomorrow"). Value is set using local (not UTC) time.
Optional
dueDate Due Date string
Specific date in YYYY-MM-DD format relative to user’s timezone
Optional
dueDatetime Due Datetime string
Specific date and time in RFC3339 format in UTC.
Optional
dueLang Due Language string
2-letter code specifying language in case due_string is not written in English
Optional
assignee Assignee string
The responsible user (if set, and only for shared tasks)
Optional Dynamic

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
todoist-create-task
Version
0.0.12
App
Todoist
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes