Connect a mailbox in one step.

// In your webhook handler
if (event.known && event.type === "account.reauth_required") {
  const { url } = await workwae.connectSessions.create({
    accountId: event.accountId,
    providers: ["google", "microsoft", "imap"],
    redirectUri: "https://app.example.com/mail/connected",
    ttlSeconds: 86_400,
  });
  // e.g. "invalid_grant"
  await emailUser(event.data.externalRef, url, event.data.reason);
}

// Without a redirect URI, follow the session
const s = await workwae.connectSessions.get({ sessionId });
// s.status: "pending" | "completed" | "failed"
if (s.status === "failed") console.warn(s.error);

// Everything still waiting on a user
const { items } = await workwae.accounts.list({
  status: "reauth_required",
});

import { isApiError } from "@workwae/sdk";

try {
  const found = await workwae.autoconfig.lookup({ email });
  // Google or Microsoft hosts it: offer that sign-in
  if (found.oauth) return offerSignIn(found.oauth);
} catch (error) {
  if (!isApiError(error, "autodiscovery_failed")) throw error;
  return askForServers(email);
}

// Servers left out: found again, then checked by logging in
const account = await workwae.imapAccounts.create({
  email,
  password: appPassword,
  externalRef: user.id,
});

// Later: the server refused the password; the user sent a new one
await workwae.imapSettings.update({
  accountId: account.id,
  password: newPassword,
});