MailReach

Overview of the MailReach project this connection is authorized for: name, seats, remaining credits, number of connected mailboxes, and the permissions this connection has.

get_project

Aggregated daily deliverability statistics across the project (messages sent, landed in inbox, in spam, in categories, missing) with an overall inbox rate. Optionally restricted to mailboxes on given domains, carrying a tag, or by recipient provider. Consolidated data ends 2 days ago.

get_project_stats

Full result of one spam test: inbox placement per seed mailbox, score, blacklists, authentication (SPF/DKIM/DMARC) and content analysis. Poll it after sending the test email until `completed` is true.

get_spam_test

Batch-connect mailboxes through an email workspace (Google Workspace or Microsoft 365). Up to 4 addresses are connected right away and per-address errors are returned; more run in the background and a `task_id` is returned to poll with get_import_task. Each connected mailbox uses a warming seat unless `spamchecker_only` is true.

import_workspace_accounts

List the email accounts (mailboxes) connected to the project, with their reputation score, status and warming settings. Paginated; filter by search term, tag, status or maximum score.

list_accounts

The alerts configured on the project (Slack channel and/or webhook notified when a mailbox gets disconnected, its reputation drops, an automated spam test completes...), with the events that can be subscribed and the Slack channels connected to the project.

list_alerts

List the email workspaces of the project: the Google Workspace (domain-wide delegation) or Microsoft 365 / Outlook (app registration) credentials used to batch-connect mailboxes. Use import_workspace_accounts to connect mailboxes through one of them.

list_email_workspaces

Open alerts on the project: disconnected mailboxes, reputation drops, missing emails, expiring domains, and so on. Newest first. Optionally filtered to one account or one event type.

list_notifications

List the spam tests run on the project, newest first, 10 per page. Each item carries its public_id (for get_spam_test), subject, sender, score and completion state.

list_spam_tests

Tags defined on the project (used to group mailboxes), with the average score of the tagged mailboxes.

list_tags

Pause warming on one mailbox: it stops sending and receiving warming conversations but stays connected to MailReach and keeps its history. Use resume_account to start again.

pause_account

Ask MailReach to try reconnecting a mailbox whose status is 'disconnected' (re-tests its app password / IMAP-SMTP credentials, or refreshes its Microsoft token). Only a disconnected mailbox can be reconnected: a paused one needs resume_account, an active one needs nothing. The attempt runs in the background; check get_account a few minutes later. If it keeps failing, the user must reconnect it from the dashboard (see get_mailbox_connect_link).

reconnect_account

Disconnect a mailbox from MailReach for good: warming and spam tests stop, its seat is released and its history is no longer shown. This cannot be undone; the mailbox has to be connected again from the dashboard to come back. Requires confirm=true — ask the user before calling it.

remove_account

Rename a tag of the project. The mailboxes keep the tag under its new name.

rename_tag

Resume warming on a mailbox that was paused (status 'paused'). A 'disconnected' mailbox cannot be resumed: MailReach lost access to it, use reconnect_account or send the user to the dashboard.

resume_account

Start a held autofix immediately instead of waiting out the sender window (the pause that protects the mailbox after a sending burst).

run_autofix_now

Conclude a paused autofix with what has been measured so far instead of running the remaining probes. Confirm with the user first: the remaining probes cannot be run afterwards.

skip_autofix_remaining_tests

Start an autofix on a spam test that landed in spam: MailReach sends probe variants of the email from the same mailbox to find what causes the placement (wording, HTML, links...) and, when it can, proposes a rewrite. Free: it consumes no spam test credit. Takes a while; poll get_autofix. A test older than 12 hours is accepted: MailReach first sends the original email again to check its current placement, and only goes on when the spam placement reproduces. Refused when the mailbox is not warmed enough, the test content is empty or its authentication fails.

start_autofix

Attach a tag to a mailbox. The tag must exist (create_tag). Identify the mailbox by id or email and the tag by id or name.

tag_account

Detach a tag from a mailbox. The tag itself is kept.

untag_account

Change the settings of one connected mailbox: sender name, email signature, description, time zone, warming ramp-up (daily target and increase), maximum parallel warming conversations, and autopilot (MailReach picks the warming recipe). Only the fields you pass are changed; the values they replace are not kept, so confirm the change with the user first. Identify the account by id or email.

update_account_settings

Change an alert: enable or disable it, change its events, its channel, its Slack channel or webhook URL. Only the given fields change; events replace the previous list, and the replaced values are not kept, so confirm the change with the user first.

update_alert