Todoist integration

What it does

The Todoist integration lets your agency drive tasks and projects inside your clients' Todoist accounts without leaving TaskJuice. Connect an account once and your workflows can create, update, close, and delete tasks against the Todoist REST API v2, list and create projects, and react in real time when tasks are added, updated, completed, or deleted in the workspace.

Connect a Todoist account

1. Open your workspace in TaskJuice and navigate to Connections.
2. Choose Todoist and click Connect.
3. Sign in to the Todoist account that owns the workspace you want to wire up and approve the requested scopes.
4. TaskJuice returns you to the workspace with the connection ready to use in any workflow.

To revoke access, open your Todoist Integrations settings and remove the TaskJuice authorization. See the Todoist OAuth guide for the full grant flow.

Triggers

• todoist/task-added fires when a new task is added in the workspace (item:added event). The activation payload carries the event_name, the event_data for the added task, the initiator who created it, and the triggered_at timestamp.
• todoist/task-updated fires when a task is updated (item:updated event). Use it to react to content, priority, due-date, or label changes.
• todoist/task-completed fires when a task is marked complete (item:completed event).
• todoist/task-deleted fires when a task is removed (item:deleted event).

Every inbound POST is authenticated by recomputing HMAC-SHA256 over the raw request body using your OAuth app's client secret, and comparing the base64 digest against the value Todoist sends in the X-Todoist-Hmac-SHA256 header. Activations that fail the check are rejected before they reach your workflow.

Actions

• todoist/create-task creates a task in a project or section with content, description, labels, priority, due date, and assignee.
• todoist/get-task retrieves a single task by ID.
• todoist/update-task updates an existing task's content, description, labels, priority, due date, or assignee.
• todoist/close-task closes (completes) a task.
• todoist/delete-task removes a task from the workspace.
• todoist/list-projects lists every project visible to the connected user.
• todoist/create-project creates a new project with optional parent, color, favorite flag, and view style.

Known limitations

• The Todoist REST API enforces a per-token rate limit of 450 requests per 15 minutes for partial sync endpoints. When a 429 status is returned, TaskJuice surfaces it as a retryable error so the workflow can back off and retry.
• Webhook subscriptions are configured on the Todoist app, not per workspace, and apply to every user who authorizes the app. Scope the workflow to filter on user_id when targeting a single client.
• Reminders, comments file uploads, and shared-team features sit behind separate endpoints not currently exposed by the integration.