latestOpenAPI 3.1.02026-08-211061591.1 MB

69a962f1578f

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

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.

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

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.

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