Everything you need to build on Workwae.
One REST API for Gmail, Microsoft 365 and IMAP mailboxes, calendars and contacts. Connect accounts, read and send mail, manage events, and hear about every change by webhook or change feed.
import { createClient } from "@workwae/sdk";
const workwae = createClient({ apiKey: process.env.WORKWAE_API_KEY });
// One link: Google, Microsoft or any IMAP mailbox.
const session = await workwae.connectSessions.create({
redirectUri: "https://app.example.com/mail/connected",
providers: ["google", "microsoft", "imap"],
externalRef: user.id,
});
// Once the account is connected, read its mail.
const { items } = await workwae.search.messages({ accountId, q: "invoice" });{
"id": "1849203",
"type": "account.connected",
"accountId": "6f1c2a4e-8b3d-4e5f-9a7b-1c2d3e4f5a6b",
"createdAt": "2026-05-04T09:30:00.000Z",
"data": {
"provider": "google",
"externalRef": "user_42"
}
}Guides
From the first call to production.
Task-focused guides, with examples in cURL and TypeScript.
Quickstart
Create an API key, make your first call, connect a mailbox and read its mail.
Authentication
API keys and their scopes, account-limited keys, rotation and account tokens for browsers.
Connect accounts
Hosted connect pages, headless OAuth, your own OAuth apps and reauthorization.
Read mail
Mailboxes, search, messages and threads, flags and moves, and how sync works.
Send mail
The outbox, scheduling and undo, drafts, mail merges, tracking and unsubscribes.
Calendar and contacts
Events, invitations, finding a free time, scheduling links and contacts.
Events and webhooks
Every change as an event: signed webhooks, the change feed, replays and test events.
MCP server
Connect AI agents with an API key or OAuth: tools by scope, safe sending and prompts.
Errors and limits
Error reasons, pagination, rate limits, request ids and idempotency keys.
Reference
Every operation, with its examples.
The API reference is generated from the same contract the API and the SDK are built on, so it cannot drift from what the API does.
Ready to connect your first mailbox?
Workwae is onboarding early-access teams.