NEWNow you can connect Shakehand with Claude, ChatGPT, and any other AI tool you want!Connect Now
DOCSDocumentation
5 min readUpdated November 2026

Mailbox Health, Disconnects & Reconnect

How Shakehand detects that a mailbox stopped working, what happens to your campaigns meanwhile, and how to fix it in one click.

In short

Mailboxes break when a password changes, an App Password or OAuth access is revoked, or the provider disables the account. Shakehand checks every connected mailbox about every 15 minutes, marks it "Reconnect" only when the provider really rejected the login, alerts you once, and keeps your campaign emails waiting (not lost) until you reconnect.

Key Feature Highlights
  • Automatic login check about every 15 minutes
  • Only real login rejections count as a disconnect
  • One alert per disconnect: in-app, Slack and email
  • Campaign emails wait; nothing is dropped
  • Warmup pauses and resumes automatically
  • One-click Reconnect from the Accounts page

How a disconnect is detected

For Google and Microsoft mailboxes Shakehand refreshes the OAuth token; for SMTP mailboxes it performs an SMTP login; IMAP logins are also checked while reading the inbox. A sending error during a campaign triggers the same check.

Only a definite rejection from the provider (for example "535 authentication failed", "invalid_grant" / token revoked, or IMAP "AUTHENTICATIONFAILED") marks the mailbox as disconnected. Temporary problems such as timeouts, "try again later", rate limits or a provider outage do not, so you will not get false alarms when Gmail or Outlook has a bad minute.

Server-side configuration problems never disconnect you
If the problem is on Shakehand's side (for example an OAuth app configuration issue), mailboxes are not marked as disconnected and you are not asked to reconnect.

What happens when a mailbox disconnects

The mailbox shows a red "Reconnect" tag in Accounts with the reason underneath. You get one notification in the app, in Slack (if connected) and by email. You will not be notified again for the same disconnect.

Affected itemWhat Shakehand does
First emails of a sequenceMoved to another of your connected mailboxes if one is available, otherwise they wait
Follow-upsWait for the same mailbox to be reconnected, so the conversation thread stays intact
WarmupPaused automatically; resumes when you reconnect
RepliesCannot be read from that mailbox until it is reconnected

How to reconnect

Click the "Reconnect" tag on the mailbox row in Accounts.

1. Google/Microsoft OAuth: sign in again and approve access.
2. SMTP/IMAP: enter the new password or a new App Password.
3. The tag changes back to Connected, warmup resumes and waiting emails start sending again within a few minutes.

Sending quota errors are not disconnects

Providers limit how much one mailbox can send per day (for example Gmail's "daily user sending limit exceeded"). Shakehand recognises these messages as a quota problem of the sending mailbox, not as a bad recipient: the email is retried automatically about 6 hours later and the prospect is not marked as bounced.