Tag action

Applies one or more tags to the message. Tags must already exist in the mailbox; unknown tag names are silently dropped.

{
  "name":  "Mark VIP and region",
  "type":  "tag",
  "value": { "tags": ["VIP", "Europe"] }
}

Action object

type"tag"

Always "tag".

name?string

Optional label for diagnostics.

valueobject

See below.

tagsstring[]

Tag names to apply, as they appear in the mailbox. Match is case-sensitive — see Notes. Names not configured for the mailbox are silently dropped.

Tag names are case-sensitive and must exactly match what’s configured in Admin.
Use the List mailboxes endpoint to discover the tag names defined for a mailbox.