> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirebox.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Email

> Send an outbound email or reply to an ongoing conversation thread.

### Body Parameters

<ParamField body="agent" type="string" required>
  The agent handle sending the email (e.g. `eva`).
</ParamField>

<ParamField body="to" type="string[]" required>
  Array of recipient email addresses.
</ParamField>

<ParamField body="subject" type="string" required>
  Email subject line.
</ParamField>

<ParamField body="text" type="string" required>
  Plain-text message body.
</ParamField>

<ParamField body="html" type="string">
  Optional HTML formatted body.
</ParamField>

<ParamField body="thread_id" type="string">
  Optional thread ID to reply to. Wirebox will set `In-Reply-To` and `References` headers automatically.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.wirebox.sh/api/v1/mail/send \
    -H "Authorization: Bearer $WIREBOX_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "agent": "eva",
      "to": ["user@example.com"],
      "subject": "Re: Support Ticket #1042",
      "text": "Hello! Your ticket has been updated.",
      "thread_id": "thrd_01J8XYZ987ABC"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "id": "msg_01J8OUTBOUND789",
    "thread_id": "thrd_01J8XYZ987ABC",
    "status": "queued",
    "created_at": "2026-09-11T12:05:00Z"
  }
  ```
</ResponseExample>