# Send Gmail message

Canonical URL: https://docs.fuse.init.inc/integrations/google-workspace/actions/gmail.messages.send

Send a small text or HTML email as the connected Google principal.

Action ID: `gmail.messages.send`
Provider: Google Workspace (`google_workspace`)
Contract version: 1

## Risk and exposure

- Risk: Write
- Idempotency: Unsafe — Retries may duplicate side effects; callers must coordinate carefully.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=false, destructive=false, idempotent=false, openWorld=true

## Required scopes

- `https://www.googleapis.com/auth/gmail.send`

## Input schema fields

- `to`
- `subject`
- `body`
- `body_html`
- `cc`
- `bcc`

## Output schema fields

- `id`
- `thread_id`

Provider overview: https://docs.fuse.init.inc/integrations/google-workspace
Actions index: https://docs.fuse.init.inc/integrations/google-workspace/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/google_workspace/actions/gmail.messages.send
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/google_workspace/actions