Connect Human Inbox

Connect a human-owned mailbox using OAuth or IMAP credentials.

View as Markdown

Connect a human inbox to enable sync, smart routing, and context APIs.

OAuth Flow

  1. Create an auth URL with POST /human/v0/auth/url.
  2. Send the user through provider consent.
  3. Confirm the connection with POST /human/v0/auth/confirm.

IMAP + SMTP Credentials

Use POST /human/v0/auth/tokens with provider settings and credentials, then confirm the account.

Verify Connection

List active accounts:

curl "$API_URL/human/v0/accounts" \
  -H "Authorization: Bearer $API_KEY"