Email2Chat API

Returns monitoring status for all connected email accounts.

{
  "accounts": [
    {
      "email": "[email protected]",
      "provider": "gmail",
      "status": "active",
      "last_checked": "2026-07-29T10:00:00Z",
      "notifications_today": 12
    }
  ]
}

Pause monitoring for a specific email account.

Resume monitoring for a specific email account.

Returns recent emails processed by Email2Chat with AI summaries and classifications.

{
  "emails": [
    {
      "id": "em_abc123",
      "account": "[email protected]",
      "from": "[email protected]",
      "subject": "Meeting tomorrow",
      "received_at": "2026-07-29T09:41:00Z",
      "ai_summary": "Meeting at 3pm in room B.",
      "ai_label": "Important",
      "ai_label_confidence": 0.94
    }
  ],
  "total": 47,
  "page": 1,
  "page_size": 20
}

Mark an email as read in the original inbox (Gmail/Outlook).

Archive an email in the original inbox.

Register a webhook endpoint.

// Request
{
  "url": "https://yourapp.com/email-hook",
  "secret": "your_signing_secret",
  "events": ["email.received", "email.classified"]
}

// Payload sent to your URL on new email
{
  "event": "email.received",
  "timestamp": "2026-07-29T09:41:00Z",
  "data": {
    "account": "[email protected]",
    "from": "[email protected]",
    "subject": "Meeting tomorrow",
    "ai_summary": "Meeting at 3pm in room B.",
    "ai_label": "Important"
  }
}

Payloads are signed with HMAC-SHA256. Verify the X-Email2Chat-Signature header.

Open a persistent SSE connection. Events arrive as they happen.

// JavaScript example
const es = new EventSource(
  "https://email2chat.com/sse",
  { headers: { "Authorization": "Bearer em2c_..." } }
);

es.addEventListener("email.received", (e) => {
  const email = JSON.parse(e.data);
  console.log("New email:", email.subject);
});