TOtodoist
Labels

Create Label

Create a personal label.

Premium limits apply to personal label creation. Free users who exceed the plan limit receive a premium-only error.

post/api/v1/labels

Request

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

Request body

namestring required

Name of the new label.

orderinteger nullable

Position of the new label in the label list

is_favoriteboolean

Whether the label is marked as a favorite.

Example request

{
  "name": "Priority",
  "order": 12
}

Response

Successful Response

idstring required

String ID of the label.

namestring required

Label name.

colorstring required

Label color name.

orderinteger nullable required

Position of the label in the label list, or null when no explicit order is set.

is_favoriteboolean required

Whether the label is marked as a favorite.

Example response

{
  "id": "2147509004",
  "name": "Priority",
  "color": "berry_red",
  "order": 12
}

Changes

No recorded changes to this operation across all 34 revisions of this API.