Skip to content

Gmail: Manage Messages

Plugin ID: eca_gmail_manage_messages

Available since: 1.0.0

Archive, trash, restore, or permanently delete emails with support for bulk operations and automated housekeeping workflows.

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

Message IDs — config key: message_ids

Gmail message IDs to manage (comma-separated). Supports token replacement.
This field supports tokens.

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

Action — config key: action

Management action to perform on the messages.

Type: select · Required: yes · Default: archive

Allowed values: archive, trash, restore, delete

Management Results Token Name — config key: management_token_name

Optional token name to store management results. Accessible as [token_name:affected_messages], [token_name:action], [token_name:total_requested], etc.

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