create_list

create_list

Create a new list directly in a ClickUp space. Use this tool when you need a top-level list not nested inside a folder. Before calling, check if you already have the necessary space ID from previous responses in the conversation, as this avoids redundant lookups. For creating lists inside folders, use create_list_in_folder instead.

Input Schema

Name	Required	Description
`assignee`	No	User ID to assign the list to
`content`	No	Description or content of the list
`dueDate`	No	Due date for the list (Unix timestamp in milliseconds). Convert dates to this format before submitting.
`folderId`	No	ID of the folder to create the list in (required if not using spaceId). If you have this ID from a previous response, use it directly rather than looking up by name.
`name`	No	Name of the list
`priority`	No	Priority of the list (1-4), where 1 is urgent/highest priority and 4 is lowest priority. Only set when explicitly requested.
`spaceId`	No	ID of the space to create the list in (required if not using folderId). If you have this ID from a previous response, use it directly rather than looking up by name.
`status`	No	Status of the list

Input Schema (JSON Schema)

{
  "allOf": [
    {
      "oneOf": [
        {
          "required": [
            "spaceId"
          ]
        },
        {
          "required": [
            "folderId"
          ]
        }
      ]
    },
    {
      "required": [
        "name"
      ]
    }
  ],
  "properties": {
    "assignee": {
      "description": "User ID to assign the list to",
      "type": "number"
    },
    "content": {
      "description": "Description or content of the list",
      "type": "string"
    },
    "dueDate": {
      "description": "Due date for the list (Unix timestamp in milliseconds). Convert dates to this format before submitting.",
      "type": "string"
    },
    "folderId": {
      "description": "ID of the folder to create the list in (required if not using spaceId). If you have this ID from a previous response, use it directly rather than looking up by name.",
      "type": "string"
    },
    "name": {
      "description": "Name of the list",
      "type": "string"
    },
    "priority": {
      "description": "Priority of the list (1-4), where 1 is urgent/highest priority and 4 is lowest priority. Only set when explicitly requested.",
      "type": "number"
    },
    "spaceId": {
      "description": "ID of the space to create the list in (required if not using folderId). If you have this ID from a previous response, use it directly rather than looking up by name.",
      "type": "string"
    },
    "status": {
      "description": "Status of the list",
      "type": "string"
    }
  },
  "type": "object"
}

Input Schema

Input Schema (JSON Schema)

Other Tools