HelpfulAI
HelpfulAI ACP (agent communications)
HelpfulAI ACP (agent communications)

Email

Serverhttps://mqqsoutginqsajeuttyp.supabase.co/functions/v1

The assistant mailbox reply path.

Draft and send (or draft only) the reply to one assistant mailbox email

POST
https://mqqsoutginqsajeuttyp.supabase.co/functions/v1
/process-assistant-email

Internal dispatch from scheduled-runner's email monitor and execute-ai-agent. Only the service-role key or the avatar service token may call it. Replies once per (userAgentId, messageId); a repeat returns skipped. The handler does not check the HTTP method; dispatchers send POST.

Draft and send (or draft only) the reply to one assistant mailbox email › Request Body

AssistantEmailDispatch
userAgentId
​string · minLength: 1 · required
userId
​string · minLength: 1 · required
messageId
​string · minLength: 1 · required
assistantId
​string | null

Null for personal or draft mode.

threadId
​string | null
fromEmail
​string | null
subject
​string | null
body
​string | null
replyStyle
​string | null
draftMode
​boolean | null

Create a Gmail draft instead of sending.

Draft and send (or draft only) the reply to one assistant mailbox email › Responses

Replied, drafted, or skipped.

success
​boolean · required
skipped
​boolean
reason
​string · enum
Enum values:
already_replied
in_progress
duplicate
messageId
​string
replyMessageId
​string | null
creditsUsed
​integer
Inbound eventsCalendar