Skip to content

Email (Gmail)

Send emails through connected Google accounts — gated by the per-account daily send budget and warming system — and configure Google App Passwords.

Full name: campaignstack_send_gmail

google_integrations:write

Send an email via Gmail using a connected Google account. Requires a Google account to be connected and linked to the workspace — use the Google integrations settings in the app to connect one first. If googleAccountId is omitted, uses the first connected Google account linked to the workspace. Returns the Gmail messageId and threadId on success. Provide htmlBody for rich formatting; body is used as the plain-text fallback.

NameTypeRequiredDefaultDescription
workspaceIdstringNoWorkspace ID (defaults to the bound workspace)
tostringYesRecipient email address
subjectstringYesEmail subject line (min length: 1)
bodystringYesPlain-text email body (min length: 1)
htmlBodystringNoOptional HTML email body (used instead of body for rich formatting)
googleAccountIdstringNoGoogle account ID to send from. Defaults to the first connected Google account linked to the workspace.

Full name: campaignstack_set_google_app_password

workspace:write Idempotent

Set or update the Google App Password for a connected Google account. Validates the App Password via IMAP before storing it encrypted. Required for email warmup (MailReach integration) and future IMAP-based features. Generate an App Password at myaccount.google.com > Security > App Passwords. IMAP must be enabled in Gmail settings. Returns { success: true, status: ‘valid’, authenticatedEmail } on success. Use campaignstack_list_integrations to find valid googleAccountId values.

NameTypeRequiredDefaultDescription
workspaceIdstringNoWorkspace ID (defaults to the bound workspace)
googleAccountIdstringYesGoogle account ID to configure the App Password for. Use campaignstack_list_integrations to find valid account IDs. (min length: 1)
appPasswordstringYes16-character Google App Password (without spaces). Generate one at myaccount.google.com > Security > App Passwords. (min length: 1, max length: 64)
emailstringNoEmail address to associate with this App Password (defaults to the account’s primary email). Used to verify IMAP authentication matches the correct account.