TIticktick

Create a tag

Changed on

name and label are required. After trimming, lowercasing, and truncating each value to 64 emoji-aware characters, they must be equal. New tags are always created as personal tags.

post/open/v1/tag

Request

  • Base URL
    https://ticktick.com
  • Auth
    none declared

Request body

namestring required

Normalized tag name. Required to update or delete a tag.

labelstring required

Display label. It is set at creation and changes with a rename.

sortOrderinteger

Sort position.

sortTypestring

Sort grouping type.

colorstring

Tag color.

parentstring

Parent tag name for a nested tag.

type1 | 2

Tag type: 1 for personal or 2 for shared. New tags are personal tags (1).

Response

The created tag.

namestring

Normalized tag name. Required to update or delete a tag.

labelstring

Display label. It is set at creation and changes with a rename.

sortOrderinteger

Sort position.

sortTypestring

Sort grouping type.

colorstring

Tag color.

parentstring

Parent tag name for a nested tag.

type1 | 2

Tag type: 1 for personal or 2 for shared. New tags are personal tags (1).

Changes