TOtodoist
Projects

Create Project From Csv

Changed on

Create a project from CSV and return its ID and imported objects.

Send a multipart file upload or raw CSV request body. For raw CSV, pass name and optional workspace_id as query parameters. Invalid UTF-8 bytes are replaced.

post/api/v1/projects/import

Request

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

Query parameters

namestring

Name of the new project.

Example:My Project

Send in the query string for raw uploads, or the form for multipart uploads. Required for raw uploads.

workspace_idstring nullable

Workspace ID for the new project. Omit to create a personal project.

Example:123456

Send in the query string for raw uploads, or the form for multipart uploads.

Request body multipart/form-data

namestring required

Name of the new project.

workspace_idstring nullable

Workspace ID for the new project. Omit to create a personal project.

filestring binary required

Example request

{
  "name": "My Project",
  "workspace_id": "123456"
}

Response

Successful Response

status'ok' required

Always ok on success.

project_idstring required

ID of the project created from the template.

template_type'project' required

Type of template that was imported.

Example response

{
  "project_view_options_defaults": [
    {
      "project_id": "6XGgm6PHrGgMpCFX",
      "calendar_settings": {
        "visible_day_count": 1
      }
    }
  ],
  "status": "ok",
  "project_id": "6XGgm6PHrGgMpCFX",
  "template_type": "project",
  "projects": [
    {
      "access": {
        "configuration": {},
        "visibility": "restricted"
      },
      "can_assign_tasks": false,
      "can_comment": true,
      "child_order": 1,
      "color": "lime_green",
      "created_at": "2025-01-15T10:30:00Z",
      "creator_uid": "1234567",
      "default_order": 0,
      "description": "",
      "id": "6XGgm6PHrGgMpCFX",
      "is_archived": false,
      "is_collapsed": false,
      "is_deleted": false,
      "is_favorite": false,
      "is_frozen": false,
      "is_shared": false,
      "name": "Shopping List",
      "order_key": "a1V",
      "public_access": false,
      "public_key": "",
      "role": "CREATOR",
      "updated_at": "2025-01-16T10:30:00Z",
      "view_style": "list"
    }
  ],
  "sections": [
    {
      "added_at": "2025-01-15T10:30:00Z",
      "description": "Tasks for the launch plan",
      "id": "6fFPHV272WWh3gpW",
      "is_archived": false,
      "is_collapsed": false,
      "is_deleted": false,
      "name": "Introductions",
      "order_key": "a1V",
      "project_id": "6XGgm6PHrGgMpCFX",
      "section_order": 1,
      "updated_at": "2025-01-16T10:30:00Z",
      "user_id": "1234567"
    }
  ],
  "tasks": [
    {
      "added_at": "2025-01-15T10:30:00Z",
      "added_by_uid": "1234567",
      "checked": false,
      "child_order": 1,
      "completed_count": 3,
      "content": "Welcome the new hire",
      "day_order": -1,
      "description": "",
      "id": "6XGgmFVcrG5RRjVr",
      "is_collapsed": false,
      "is_deleted": false,
      "labels": [],
      "note_count": 0,
      "order_key": "a1V",
      "postponed_count": 1,
      "priority": 1,
      "project_id": "6XGgm6PHrGgMpCFX",
      "section_id": "6fFPHV272WWh3gpW",
      "updated_at": "2025-01-16T10:30:00Z",
      "user_id": "1234567"
    }
  ],
  "comments": [
    {
      "content": "Great idea!",
      "id": "6Xw8x1xCFFw6Q5p9",
      "is_deleted": false,
      "item_id": "6XGgmFVcrG5RRjVr",
      "posted_at": "2025-01-15T10:30:00Z",
      "posted_uid": "1234567"
    }
  ],
  "project_notes": [
    {
      "content": "Project kickoff notes",
      "id": "6Xw8x1xCFFw6Q5q0",
      "is_deleted": false,
      "posted_at": "2025-01-15T10:30:00Z",
      "posted_uid": "1234567",
      "project_id": "6XGgm6PHrGgMpCFX"
    }
  ],
  "reminders": [
    {
      "due": {
        "date": "2025-02-12T09:00:00",
        "lang": "en",
        "timezone": "Europe/Madrid"
      },
      "id": "6XGgmFQrx44wfGHr",
      "is_deleted": false,
      "is_urgent": false,
      "item_id": "6XGgmFVcrG5RRjVr",
      "minute_offset": 30,
      "notify_uid": "1234567",
      "type": "relative"
    }
  ],
  "discarded_fields": [
    {
      "field": "duration",
      "reason": "workspace_plan_limit"
    }
  ]
}

Changes