Skip to content

Gmail: List Labels

Plugin ID: eca_gmail_list_labels

Available since: 1.0.0

Retrieve all Gmail labels with their internal IDs for use in other Gmail actions like Apply Labels.

Fields

Authentication Type — config key: auth_type

Choose between API Client (OAuth2) or Service Account authentication.

Type: select · Required: yes · Default: api_client

Allowed values: api_client, service_account

Authentication Source — config key: auth_from

Choose whether to select authentication directly or use a token for dynamic selection.

Type: select · Required: yes · Default: direct

Allowed values: direct, token

API Client — config key: api_client_id

Search and select an API Client for OAuth2 authentication.

Type: textfield · Required: no · Default: empty string

Service Account — config key: service_account_id

Search and select a Service Account for server-to-server authentication.

Type: textfield · Required: no · Default: empty string

Client ID from Token — config key: auth_client_from_token

Token that resolves to a client ID (e.g., [user:field_google_client_id]). The token should contain just the client ID, not the auth type prefix.
This field supports tokens.

Type: textfield · Required: no · Default: empty string

Labels Token Name — config key: labels_token_name

Optional token name to store label information. Accessible as [token_name:labels:0:id], [token_name:labels:0:name], [token_name:system_labels], [token_name:user_labels], etc.

Type: textfield · Required: no · Default: empty string