Skip to content

Email Warmup

Manage automated email warmup for connected Google accounts — enable, disable, check progression, and view workspace-wide warmup states.

Full name: campaignstack_enable_warmup

workspace:write

Enable email warmup for a connected Google account via MailReach. Requires a Google App Password to be configured first (use campaignstack_set_google_app_password). Costs 6,250 credits (covers the ~4 week warming period). Once the reputation score reaches 80, warmup completes automatically. Optionally specify warmupEmail to warm a verified alias instead of the primary address. Fails if this email address is already being warmed on another account. Returns { ok: true, alreadyEnabled } on success. Use campaignstack_list_workspace_warmups to see all warmup states before enabling.

NameTypeRequiredDefaultDescription
googleAccountIdstringYesGoogle account ID to enable warmup for. Use campaignstack_list_integrations to find valid account IDs. (min length: 1)
workspaceIdstringNoWorkspace ID (defaults to the bound workspace)
warmupEmailstringNoEmail address to warm up (defaults to the account’s primary email). Can be an alias if the alias is verified in the account settings.

Full name: campaignstack_disable_warmup

workspace:write Destructive Idempotent

Disable email warmup for a connected Google account. Credits already used are not refunded. If warmup is restarted later, it begins from week 1 of the ramp-up process (costs credits again). Returns { success: true, previousStatus } where previousStatus is ‘warming’ or ‘warmed’. If no active warmup exists for the account, returns an informational message. Use campaignstack_list_workspace_warmups to see all warmup states.

NameTypeRequiredDefaultDescription
googleAccountIdstringYesGoogle account ID to disable warmup for. Use campaignstack_list_integrations to find valid account IDs. (min length: 1)
workspaceIdstringNoWorkspace ID (defaults to the bound workspace)

Full name: campaignstack_get_warmup_status

workspace:read Read-only Idempotent

Check the email warmup status for a single Google account. Returns provider, status, warmupEmail, score, and daysSinceStart. For MailReach warmup, also returns totalMessagesSent, totalMessagesReceived, and rampupTarget from the last sync. For manual warmup entries, returns a note explaining that no progression data is available. Returns an informational message if no warmup is configured. Use campaignstack_list_workspace_warmups for a workspace-wide overview. Use campaignstack_enable_warmup to start automated warmup.

NameTypeRequiredDefaultDescription
googleAccountIdstringYesGoogle account ID to check warmup status for. Use campaignstack_list_integrations to find valid account IDs. (min length: 1)
workspaceIdstringNoWorkspace ID (defaults to the bound workspace)

Full name: campaignstack_mark_as_warmed_up

workspace:write Idempotent

Mark a Google account as already warmed up without using MailReach. Use this when the inbox was warmed externally (another tool, manual warmup, or aged inbox with good reputation). Free — does not cost credits (no MailReach involvement). Fails if this email address already has an active warmup on another account. Returns { ok: true, alreadyEnabled } on success. Use campaignstack_enable_warmup instead to start automated warmup via MailReach.

NameTypeRequiredDefaultDescription
googleAccountIdstringYesGoogle account ID to mark as warmed up. Use campaignstack_list_integrations to find valid account IDs. (min length: 1)
workspaceIdstringNoWorkspace ID (defaults to the bound workspace)
warmupEmailstringNoEmail address to mark as warmed (defaults to the account’s primary email). Can be a verified alias.

Full name: campaignstack_list_workspace_warmups

workspace:read Read-only Idempotent

List all Google accounts in a workspace with their warmup status. Returns every account (even those without warmup), with status: ‘not_started’, ‘warming’, ‘warmed’, or ‘disabled’. Includes score, daysSinceStart, provider, warmupEmail, and whether an App Password is configured. Use this to get a workspace-wide warmup overview before enabling or disabling warmup on specific accounts.

NameTypeRequiredDefaultDescription
workspaceIdstringNoWorkspace ID (defaults to the bound workspace)