gogcli/docs/commands/gog-send.md

gog send

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

Send an email (alias for 'gmail send')

Usage

gog send [flags]

Parent

• gog

Flags

Flag	Type	Default	Help
--access-token	string		Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h)
-a --account --acct	string		Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads)
--attach	[]string		Attachment file path (repeatable)
--bcc	string		BCC recipients (comma-separated)
--body	string		Body (plain text; required unless --body-html is set)
--body-file	string		Body file path (plain text; '-' for stdin)
--body-html	string		Body (HTML; optional)
--cc	string		CC recipients (comma-separated)
--client	string		OAuth client name (selects stored credentials + token bucket)
--color	string	auto	Color output: auto|always|never
--disable-commands	string		Comma-separated list of disabled commands; dot paths allowed
-n --dry-run --dryrun --noop --preview	bool		Do not make changes; print intended actions and exit successfully
--enable-commands	string		Comma-separated list of enabled commands; dot paths allowed (restricts CLI)
-y --force --assume-yes --yes	bool		Skip confirmations for destructive commands
--from	string		Send from this email address (must be a verified send-as alias)
--gmail-no-send	bool	false	Block Gmail send operations (agent safety)
-h --help	kong.helpFlag		Show context-sensitive help.
-j --json --machine	bool	false	Output JSON to stdout (best for scripting)
--no-input --non-interactive --noninteractive	bool		Never prompt; fail instead (useful for CI)
-p --plain --tsv	bool	false	Output stable, parseable text to stdout (TSV; no colors)
--quote	bool		Include quoted original message in reply (requires --reply-to-message-id or --thread-id)
--reply-all	bool		Auto-populate recipients from original message (requires --reply-to-message-id or --thread-id)
--reply-to	string		Reply-To header address
--reply-to-message-id --in-reply-to	string		Reply to Gmail message ID (sets In-Reply-To/References and thread)
--results-only	bool		In JSON mode, emit only the primary result (drops envelope fields like nextPageToken)
--select --pick --project	string		In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands.
--signature	bool		Append the Gmail signature from the active send-as address
--signature-file	string		Append a local signature file (plain text or HTML)
--signature-from	string		Append the Gmail signature from this send-as email address
--subject	string		Subject (required)
--thread-id	string		Reply within a Gmail thread (uses latest message for headers)
--to	string		Recipients (comma-separated; required unless --reply-all is used)
--track	bool		Enable open tracking (requires tracking setup)
--track-split	bool		Send tracked messages separately per recipient
-v --verbose	bool		Enable verbose logging
--version	kong.VersionFlag		Print version and exit

See Also

• gog
• Command index