Todoist

Todoist is a to-do list and task management application. Protocol Launcher allows you to generate deep links to open views and add tasks in Todoist.

Usage

There are two ways to use this library:

• On-Demand import from subpaths enables tree-shaking and keeps bundles small.
• Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand

Recommended. Optimized for production.

Full Import

Convenient. Good for quick scripts.

Open App

On-Demand

import { open } from 'protocol-launcher/todoist'

const url = open()

Open Todoist

Add Task

Add a task to Todoist (Mobile only). This opens and pre-fills the form but does not automatically submit.

On-Demand

import { addTask } from 'protocol-launcher/todoist'

const url = addTask({
  content: 'Buy Milk',
  date: 'Tomorrow @ 14:00',
  priority: 4,
})

Add Task to Todoist

Open Quick Add

Open the Global Quick Add panel (Desktop only, 9.2.0+). This opens and pre-fills the panel but does not automatically submit.

On-Demand

import { openQuickAdd } from 'protocol-launcher/todoist'

const url = openQuickAdd({
  content: 'My Task',
  description: 'This is a description',
})

Open Quick Add in Todoist

Search

Search in Todoist (Android mobile and Desktop 9.10.0+).

On-Demand

import { search } from 'protocol-launcher/todoist'

const url = search({
  query: 'Test & Today',
})

Search in Todoist

Open Inbox

Open the Inbox view in Todoist.

On-Demand

import { openInbox } from 'protocol-launcher/todoist'

const url = openInbox()

Open Inbox in Todoist

Open Today

Open the Today view in Todoist.

On-Demand

import { openToday } from 'protocol-launcher/todoist'

const url = openToday()

Open Today in Todoist

Open Upcoming

Open the Upcoming view in Todoist.

On-Demand

import { openUpcoming } from 'protocol-launcher/todoist'

const url = openUpcoming()

Open Upcoming in Todoist

Open Project

Open a specific project by ID.

On-Demand

import { openProject } from 'protocol-launcher/todoist'

const url = openProject({
  id: '128501470',
})

Open Project in Todoist

Open Projects

Open the Projects view. On desktop, you can optionally filter by workspace ID.

On-Demand

import { openProjects } from 'protocol-launcher/todoist'

const url = openProjects({
  workspaceId: '1234',
})

Open Projects in Todoist

Open Label

Open a specific label. On mobile, use label name. On desktop, use label ID.

On-Demand

import { openLabel } from 'protocol-launcher/todoist'

const url = openLabel({
  name: 'Urgent',
})

Open Label in Todoist

Open Labels

Open the Labels view (Mobile only).

On-Demand

import { openLabels } from 'protocol-launcher/todoist'

const url = openLabels()

Open Labels in Todoist

Open Filter

Open a specific filter by ID.

On-Demand

import { openFilter } from 'protocol-launcher/todoist'

const url = openFilter({
  id: '9',
})

Open Filter in Todoist

Open Filters

Open the Filters view (Mobile only).

On-Demand

import { openFilters } from 'protocol-launcher/todoist'

const url = openFilters()

Open Filters in Todoist

Open Filters & Labels

Open the Filters & Labels view (Desktop only).

On-Demand

import { openFiltersLabels } from 'protocol-launcher/todoist'

const url = openFiltersLabels()

Open Filters & Labels in Todoist

Open Task

Open a specific task by ID.

On-Demand

import { openTask } from 'protocol-launcher/todoist'

const url = openTask({
  id: '12345',
})

Open Task in Todoist

Open Team Inbox

Open the Team Inbox view (Mobile only, Business accounts). Non-business accounts will be redirected to inbox.

On-Demand

import { openTeaminbox } from 'protocol-launcher/todoist'

const url = openTeaminbox()

Open Team Inbox in Todoist

Open Templates

Open the Templates view (Desktop only). You can optionally open a specific template by ID.

On-Demand

import { openTemplates } from 'protocol-launcher/todoist'

const url = openTemplates({
  id: '123',
})

Open Templates in Todoist

Open Notifications

Open the Notifications view in Todoist.

On-Demand

import { openNotifications } from 'protocol-launcher/todoist'

const url = openNotifications()

Open Notifications in Todoist

Open Profile

Open the Profile view (Mobile only).

On-Demand

import { openProfile } from 'protocol-launcher/todoist'

const url = openProfile()

Open Profile in Todoist