Sign in

v1

latestOpenAPI 3.1.02026-07-24172151607.6 KB
Lists

Create List From Template in Space

Create a new List using a List template within a Space. Publicly shared templates must be added to your Workspace before you can use them with the public API. This request can be run asynchronously or synchronously via the return_immediately parameter.

post/v2/space/{space_id}/list_template/{template_id}

Path parameters

space_idstring required

ID of the Space where the List will be created

template_idstring required
Example:t-15363293

ID of the List template to use. Template IDs include a t- prefix (e.g., t-15363293). Retrieve available template IDs using the Get List Templates endpoint.

Request body

namestring required

Name of the new List

Response

List created successfully

idstring

Unique identifier of the newly created List

Example response

{
  "id": "901107394085",
  "list": {
    "id": "901107394085",
    "name": "API Folder in Space",
    "deleted": true,
    "folder": {
      "id": "90114317916",
      "name": "hidden",
      "hidden": true,
      "access": true
    },
    "space": {
      "id": "90112667046",
      "name": "API Test Space",
      "access": true
    },
    "inbound_address": "abc-list@tasks.clickup.com",
    "override_statuses": true,
    "statuses": [
      {
        "id": "sc901107394085_DCnaeiSB",
        "status": "to do",
        "color": "#87909e",
        "type": "open",
        "status_group": "subcat_901107394085"
      }
    ],
    "permission_level": "create"
  }
}