update on IMAP smtp page

[duharry0915]

Summary by cubic

Update the IMAP/SMTP guide to reflect current server behavior and client setup. Expands IMAP folder coverage, documents IMAP IDLE, clarifies SMTP encryption and credentials, and updates examples and troubleshooting.

• New Features

  • IMAP now documents folders: INBOX, Sent, Trash, Spam; Drafts is listed but managed via the API.
  • Added IMAP IDLE support note for push-style updates.
  • SMTP docs clarify port 465 (implicit TLS) vs 587 (STARTTLS), auth rules, and show updated Python/TypeScript examples.

• Migration

  • Use your inbox email as the SMTP username (not a generic user).
  • On port 587, issue STARTTLS before AUTH; or use port 465 with implicit TLS.
  • In IMAP, select supported folders; folder names (except INBOX) are case-sensitive; manage drafts via the API.

^{Written for commit 323f267. Summary will update on new commits. Review in cubic}

[github-actions]

🌿 Preview your docs: https://agentmail-preview-65483312-94fc-4b3f-8c5f-e3f918c87085.docs.buildwithfern.com

[cubic-dev-ai]

No issues found across 1 file

_{Re-trigger cubic}