Email Bot API

Automated email handling and AI-powered composition

Overview

The Email Bot API provides endpoints for automated email handling, AI-powered composition, and email tracking.

Base Path: /email_bot

Endpoints

Compose Email

Generate email draft with AI.

POST /email_bot/compose

Request Body:

{
  "recipient": "[e-mail]",
  "company_name": "Acme Corp",
  "purpose": "follow_up",
  "context": "Following up on partnership discussion",
  "tone": "professional",
  "length": "medium"
}

Response:

{
  "subject": "Following up on our partnership discussion",
  "body": "Hi John,\n\nIt was great meeting with you last week...",
  "suggested_send_time": "2024-01-23T09:00:00Z"
}

Send Email

Send email via connected Gmail/Outlook account.

POST /email_bot/send

Request Body:

{
  "to": ["[e-mail]"],
  "subject": "Partnership proposal",
  "body": "Email content...",
  "provider": "google",
  "cc": [],
  "bcc": [],
  "attachments": []
}

Response:

{
  "sent": true,
  "message_id": "msg-123",
  "sent_at": "2024-01-22T11:00:00Z"
}

Gmail OAuth

Initialize OAuth

POST /email_bot/gmail/oauth/init

OAuth Callback

GET /email_bot/gmail/oauth/callback

Outlook OAuth

Initialize OAuth

POST /email_bot/outlook/oauth/init

OAuth Callback

GET /email_bot/outlook/oauth/callback

Complete OAuth Guide

See the full OAuth setup documentation

Next Steps

Email Agent Service

Backend implementation

OAuth Setup

Configure email OAuth