labels
List all labels accessible to the user in a hierarchical structure.
The response returns labels in a tree structure where:
- Labels are ordered alphabetically by name
- Each label includes its children (sub-labels)
- The hierarchy is determined by the label's name (e.g., "Inbox/Important" is a child of "Inbox")
You can filter labels by mailbox using the mailbox_id query parameter.
get/api/v1.0/labels/
Query parameters
mailbox_idstring uuid
Filter labels by mailbox ID. If not provided, returns labels from all accessible mailboxes.
Response
List of labels in hierarchical structure
Changes
No recorded changes to this endpoint across all 54 revisions of this API.