Mailbox identity
A Mailbox is a stable provider-and-address identity owned by one Organization. Multiple Mailboxes may be connected simultaneously — for example separate Gmail accounts for different brands or regions.
Entitlements on your Plan may limit how many Mailboxes you can connect. Each Mailbox appears in Settings with its provider, address, and connection status.
Connection Generations
Each OAuth authorization creates a Connection Generation — one credential lifecycle for a Mailbox. Provider work, messages, sync cursors, and durable commands fence the exact generation so callbacks from superseded credentials cannot mutate current state.
Reconnecting Gmail or Feishu Mail creates a new generation without changing the Mailbox identity. Historical messages remain associated with the Mailbox, not a specific token row.
Gmail synchronization
Karis syncs Gmail through paged delta sync. Incoming and outgoing messages, thread anchors, and UID validity must agree causally — cursor movement, message counts, and conversation grouping stay consistent across sync runs.
If OAuth state does not match the signed-in Karis session during handoff, you are routed to a session-mismatch safety page rather than binding the wrong Mailbox.
Feishu Mail
Feishu Mail connections follow the same Mailbox and Connection Generation model as Gmail. Provider adapters remain neutral so campaign routing and Thread binding behave the same regardless of provider.
Troubleshooting
- Sync lag — confirm the Connection Generation is active and the mailbox is not suspended by the provider.
- Wrong sender — check Campaign Default Mailbox for new Threads; bound Threads retain their original Mailbox.
- Handoff errors — complete OAuth in the same browser session you used to start connection from Settings.