---
updatedAt: 2026-03-10T18:55:54.000Z
---

Fetch the complete documentation index at: https://developer.clickup.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Custom Task Types

Create your own unique building blocks for your work with [custom task types](https://help.clickup.com/hc/en-us/articles/17564381376919-Custom-task-types).

You can work with custom task types through the ClickUp Public API.

# Get available custom task types

You can Get the custom task types for your Workspace using:

[Get Custom Task Types](https://developer.clickup.com/reference/getcustomitems)

# Create a task with a custom task type

You can use [Create Task](https://developer.clickup.com/reference/createtask) to set the custom task type on a task as you create it.

1. Use
   [Get Custom Task Types](https://developer.clickup.com/reference/getcustomitems)
   to retrieve the `ID` of the custom task type.
2. Use [Create Task](https://developer.clickup.com/reference/createtask) with the `custom_item_id`body parameter. For example:

```json
{
  "name":"New task",
	"custom_item_id": 1300
}
```

# Update the custom task type on a task

You can use [Update Task](https://developer.clickup.com/reference/updatetask) to update the custom task type on a task.

1. Use [Get Custom Task Types](https://developer.clickup.com/reference/getcustomitems) to retrieve the `ID` of the custom task type.
2. Use [Update Task](https://developer.clickup.com/reference/updatetask) with the `custom_item_id`body parameter. For example:

```json
{
	"custom_item_id": 1300
}
```

## Available values

All Workspaces will allow a value of `0`which represents task type `task`.

`1` represents the task type `Milestone`.

Other acceptable values are defined by the custom task types available in your Workspace.

To retrieve the available values, use [Get Custom Task Types](https://developer.clickup.com/reference/getcustomitems).

# Search tasks by custom task type

You can search for tasks by custom task type using the `custom_items[]` query parameter with:

* [Get Tasks](https://developer.clickup.com/reference/gettasks)
* [Get Filtered Team Tasks](https://developer.clickup.com/reference/getfilteredteamtasks)

## Using the custom\_items\[] parameter

The custom\_items\[] parameter is an array of numbers. For example:

Sending a request with `?custom_items[]=0&custom_items[]=1300` returns tasks that are type `task` and tasks using the custom task type `1300`. In this example that represents a `Bug`.

Including `0` returns tasks. Including `1` returns Milestones. Including any other number returns the custom task type as defined in your Workspace.

# Retrieve a task to view the custom task type

When you return tasks, the `custom_item_id` is included in the response body. For example:

[Get Task](https://developer.clickup.com/reference/gettask) includes the `custom_item_id`in the body of a successful (`200`) response.

A value of `null` represents the task type: `task`.