Email & PEC

Create a label

Adds a label to the tenant’s taxonomy. Nest it under an existing one with parent_id (from email_list_labels) — up to three levels deep. visibility: "private" makes it usable only by the caller’s own member, administrators included; the default "public" is shared by everyone. This does not label any message — call email_label afterwards with the name you chose.

post/api/v1/rest/email/labels

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/email/labels
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Request body

namestring required
color'slate' | 'red' | 'amber' | 'green' | 'teal' | 'blue' | 'violet' | 'pink'
parent_idstring uuid nullable

Nest under this label. Omit for the top level.

visibility'public' | 'private'

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.