Reference

`gog gmail send`

gog gmail send

Generated from gog schema --json. Do not edit this page by hand; run make docs-commands.

Send an email

#Usage

gog gmail (mail,email) send [flags]

#Parent

#Flags

FlagTypeDefaultHelp
--access-tokenstringUse provided access token directly (bypasses stored refresh tokens; token expires in ~1h)
-a
--account
--acct
stringAccount email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads)
--attach[]stringAttachment file path (repeatable)
--bccstringBCC recipients (comma-separated)
--bodystringBody (plain text; required unless --body-html is set)
--body-filestringBody file path (plain text; '-' for stdin)
--body-htmlstringBody (HTML; optional)
--ccstringCC recipients (comma-separated)
--clientstringOAuth client name (selects stored credentials + token bucket)
--colorstringautoColor output: auto|always|never
--disable-commandsstringComma-separated list of disabled commands; dot paths allowed
-n
--dry-run
--dryrun
--noop
--preview
boolDo not make changes; print intended actions and exit successfully
--enable-commandsstringComma-separated list of enabled commands; dot paths allowed (restricts CLI)
-y
--force
--assume-yes
--yes
boolSkip confirmations for destructive commands
--fromstringSend from this email address (must be a verified send-as alias)
--gmail-no-sendboolfalseBlock Gmail send operations (agent safety)
-h
--help
kong.helpFlagShow context-sensitive help.
-j
--json
--machine
boolfalseOutput JSON to stdout (best for scripting)
--no-input
--non-interactive
--noninteractive
boolNever prompt; fail instead (useful for CI)
-p
--plain
--tsv
boolfalseOutput stable, parseable text to stdout (TSV; no colors)
--quoteboolInclude quoted original message in reply (requires --reply-to-message-id or --thread-id)
--reply-allboolAuto-populate recipients from original message (requires --reply-to-message-id or --thread-id)
--reply-tostringReply-To header address
--reply-to-message-id
--in-reply-to
stringReply to Gmail message ID (sets In-Reply-To/References and thread)
--results-onlyboolIn JSON mode, emit only the primary result (drops envelope fields like nextPageToken)
--select
--pick
--project
stringIn JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands.
--signatureboolAppend the Gmail signature from the active send-as address
--signature-filestringAppend a local signature file (plain text or HTML)
--signature-fromstringAppend the Gmail signature from this send-as email address
--subjectstringSubject (required)
--thread-idstringReply within a Gmail thread (uses latest message for headers)
--tostringRecipients (comma-separated; required unless --reply-all is used)
--trackboolEnable open tracking (requires tracking setup)
--track-splitboolSend tracked messages separately per recipient
-v
--verbose
boolEnable verbose logging
--versionkong.VersionFlagPrint version and exit

#See Also