The current email API Endpoints available:

List all mail folders and subfolders

Shows unread/total message counts

Supports personal and shared mailboxes

Returns: folder_id, name, unread_count, total_count

Search/Find emails with two mutually exclusive modes:

SEARCH mode: keywords, subject, body, sender_email, email_type

FILTER mode: is_read, flag_status, importance, has_attachments, received_after, received_before

Supports folder scoping and shared mailboxes

Pagination: up to 200 results per call

Response Fields (Email Object):

email_id

subject

sender / sender_email

body (truncated to 500 chars if >10 results)

received_date_time

is_read

importance (low/normal/high)

email_type (received/sent/draft)

has_attachments (boolean flag only)

Key Limitations Documented:

NEED:

Attachment metadata (filenames, sizes, MIME types)

Complete email headers

Delivery status confirmation

Write operations (create, edit, delete, move, forward)

Email actions (mark read, add flags, etc.)

EXPAND:

Message body (truncated in large result sets)

Recipient parsing (To/CC/BCC not structured)