Emails API¶

List emails¶

GET /api/emails

curl "http://localhost:3001/api/emails?tag=Hello&limit=10"

[
  {
    "id": 1,
    "message_id": "<abc@mail.com>",
    "from_address": "lead@company.com",
    "from_name": "Jane Smith",
    "to_address": "hello@digitechnomads.com",
    "subject": "Partnership inquiry",
    "body_text": "...",
    "tag": "Hello",
    "direction": "inbound",
    "received_at": "2026-02-25T10:30:00Z"
  }
]

Create email (webhook)¶

POST /api/emails

Used by n8n to push new emails. Auto-derives tag, creates task, and saves auto-reply.

Get email with replies¶

GET /api/emails/{id}

Returns the email with associated auto-replies.

AI email analysis¶

GET /api/emails/{id}/ai-analysis

Returns AI-generated analysis of the email content including urgency, action items, and insights.

Auto-replies¶

Send email¶

POST /api/send-email

Send an email via SMTP from a selected inbox.

IMAP sync¶