Example: Gmail OAuth Send

This example shows the local Gmail API send path.

Use it when you want MailAtlas to send from a personal Gmail address or Gmail-configured send-as alias with the gmail.send OAuth scope.

Authorize Gmail locally

python -m pip install "mailatlas[keychain]"

mailatlas auth gmail \
  --client-id "$MAILATLAS_GMAIL_CLIENT_ID" \
  --client-secret "$MAILATLAS_GMAIL_CLIENT_SECRET" \
  --email [email protected]

Check status:

mailatlas auth status gmail

Send a dry run first

mailatlas send \
  --provider gmail \
  --dry-run \
  --from [email protected] \
  --to [email protected] \
  --subject "MailAtlas Gmail dry run" \
  --text "Rendered locally without contacting Gmail."

Send through Gmail API

mailatlas send \
  --provider gmail \
  --from [email protected] \
  --to [email protected] \
  --subject "MailAtlas Gmail API test" \
  --text "Sent with Gmail API OAuth." \
  --idempotency-key gmail-api-test-1

The idempotency key makes retries return the existing outbound record instead of sending a duplicate message.

Cleanup

mailatlas auth logout gmail

Next step

• Use Gmail Provider for token storage details.
• Use Outbound Email for provider behavior and BCC handling.