TOtodoist
Folders

Create Folder

Changed on

Create a new folder in the given workspace.

post/api/v1/folders

Request

  • Base URL
    https://api.todoist.com
  • URL
    https://api.todoist.com/api/v1/folders
  • Auth
    none declared

Request body

namestring required

Name of the new folder.

workspace_idinteger required

ID of the workspace to create the folder in.

default_orderinteger nullable

Default position of the folder in the workspace.

child_orderinteger nullable

User-specific position of the folder.

Example request

{
  "name": "Design",
  "workspace_id": 123456,
  "default_order": 1,
  "child_order": 1
}

Response

Successful Response

idstring required

String ID of the folder.

namestring required

Folder name.

workspace_idstring required

String ID of the workspace that contains the folder.

default_orderinteger required

Default position of the folder in the workspace.

default_order_keystring nullable required

Fractional-indexing key for the workspace's shared default-ordering scope (folders and workspace projects together). null until assigned (backfill pending).

child_orderinteger required

User-specific position of the folder.

is_deletedboolean required

Whether the folder is deleted.

Example response

{
  "id": "1234",
  "name": "Design",
  "workspace_id": "123456",
  "default_order": 1,
  "default_order_key": "a1V",
  "child_order": 1
}

Changes