Skip to content

Google: Lists all labels in the user's mailbox For more information, see Manage labels (https: developers google com workspace gmail api guides labels) — response body

Lists all labels in the user's mailbox. For more information, see [Manage labels](https://developers.google.com/workspace/gmail/api/guides/labels).: response body. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Lists all labels in the user's mailbox For more information, see Manage labels (https: developers google com workspace gmail api guides labels) — response body

FieldTypePresenceDescription and constraints
$objectRoot
labelsarrayOptionalList of labels. Note that each label resource only contains an `id`, `name`, `messageListVisibility`, `labelListVisibility`, and `type`. The [`labels.get`](https://developers.google.com/workspace/gmail/api/v1/reference/users/labels/get) method can fetch additional label details.
labels[]ModelEach itemExpand Creates a label For more information, see Manage labels (https: developers google com workspace gmail api guides labels) — response body

Referenced models: Creates a label For more information, see Manage labels (https: developers google com workspace gmail api guides labels) — response body

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.