delete_inbox
Delete an inbox.
Args:
domain_id: The domain ID
inbox_id: The inbox ID to delete
list_threads
List email threads (conversations) with pagination.
Returns thread summaries: subject, message count, last activity, snippet.
Use next_cursor from the response to fetch the next page.
Provide at least one of inbox_id or domain_id.
Args:
inbox_id: Filter threads by inbox (recommended)
domain_id: Filter threads by domain
limit: Results per page, 1-100 (default: 20)
cursor: Pagination cursor from a previous response's next_cursor
order: "desc" for newest first (default), "asc" for oldest first
get_thread_messages
Get all messages in an email thread.
Returns the full conversation with sender, content, timestamps.
Args:
thread_id: The thread ID (from list_threads)
limit: Max messages, 1-1000 (default: 50)
order: "asc" for chronological (default), "desc" for newest first
send_email
Send an email message.
Provide html or text (or both) for the body.
To reply in an existing thread, pass thread_id.
To attach files, first call upload_attachment, then pass
the attachment IDs as a comma-separated string.
You only need inbox_id to send — the domain is inferred automatically.
Args:
to: Recipient email address (for multiple, comma-separate)
subject: Email subject line
html: HTML body content
text: Plain text body (fallback)
from_address: Sender address (optional, uses inbox default)
reply_to: Reply-to address (optional)
thread_id: Reply within an existing thread (optional)
inbox_id: Send from a specific inbox (recommended — domain is auto-resolved)
domain_id: Send from a specific domain (optional, inferred from inbox_id)
attachments: Comma-separated attachment IDs from upload_attachment (optional)
upload_attachment
Upload a file for use when sending emails.
Returns an attachment_id to pass to send_email's attachments parameter.
Args:
content: Base64-encoded file content
filename: Original filename, e.g. "report.pdf"
mime_type: MIME type, e.g. "application/pdf" or "image/png"
get_attachment_url
Get a temporary download URL for an attachment.
Args:
attachment_id: The attachment ID
expires_in: URL lifetime in seconds (default: 3600 = 1 hour)
search_threads
Search across email threads by subject or content.
Returns matching thread summaries with subject, snippet, and message count.
Provide at least one of inbox_id or domain_id.
Args:
query: Search query (searches subject and message content)
inbox_id: Filter by inbox (recommended)
domain_id: Filter by domain
limit: Max results, 1-100 (default: 20)
get_thread_metadata
Get triage metadata for a thread: tags, status, and assignment.
Args:
thread_id: The thread ID
set_thread_status
Set the status of a thread for triage.
Valid statuses: "open", "needs_reply", "waiting", "closed"
Args:
thread_id: The thread ID
status: New status — one of: open, needs_reply, waiting, closed
tag_thread
Add tags/labels to a thread. Tags are additive — existing tags are preserved.
Use tags for categorization: "vip", "bug-report", "sales-lead", "urgent", etc.
Args:
thread_id: The thread ID
tags: Comma-separated tags to add (e.g. "urgent,vip,sales-lead")
untag_thread
Remove tags/labels from a thread.
Args:
thread_id: The thread ID
tags: Comma-separated tags to remove (e.g. "urgent,vip")
assign_thread
Assign a thread to an agent or user. Pass null/empty to unassign.
Args:
thread_id: The thread ID
assigned_to: Agent/user identifier to assign to (empty or omit to unassign)
get_deliverability_stats
Get email deliverability metrics: sent, delivered, bounced, complained, failed.
Provides bounce rate, complaint rate, and delivery rate percentages.
Use this to monitor sender reputation and identify deliverability issues.
Args:
inbox_id: Filter metrics by inbox (recommended)
domain_id: Filter metrics by domain
period: Time period — "24h", "7d", "30d" (default: "7d")
get_suppressions
List suppressed email addresses (bounces, complaints, unsubscribes).
Suppressed addresses are automatically skipped when sending.
Use this to audit why certain recipients aren't receiving emails.
Args:
inbox_id: Filter by inbox (optional)
limit: Max results (default: 50)
get_delivery_events
Get delivery event log: sent, delivered, bounced, complained, failed.
Track the lifecycle of individual emails or audit delivery across an inbox.
Args:
message_id: Filter events for a specific message
inbox_id: Filter events by inbox
event_type: Filter by type: "sent", "delivered", "bounced", "complained", "failed"
limit: Max results (default: 50)