---
title: "Send plain text or reply to a verified contact"
method: POST
path: "/api/v1/addresses/{addressId}/email/send"
tags: ["Mail"]
---

# Send plain text or reply to a verified contact

`POST /api/v1/addresses/{addressId}/email/send`

## Request

- Base URL: `https://agentaddress.dev`
- URL: `https://agentaddress.dev/api/v1/addresses/{addressId}/email/send`
- Auth: HTTP bearer

Operator-configured sender; Reply-To is the task's inbound address. Recipient must verify separately. Replies require a retained provider-verified email and matching sender/sole Reply-To. 20 reservations/address/UTC day, within shared service budget at most 100/day including verification. Two feed slots reserved before sending. Keys retained at least 24 hours; reuse identical key/body on retries. Pending sends recover with provider idempotency within 23 hours; later uncertainty is recorded rather than blindly resent. Accepted is provider acceptance, not delivery.

## Path parameters

- `addressId` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `to` string, email, required
  - `subject` string, required
  - `text` string, required: 10,000 UTF-8 bytes, not characters
  - `reply_to_event_id` string

## Response `200`

Authorized response; never cached

- EmailSend
  - `status` 'pending' | 'accepted' | 'failed' | 'uncertain', required
  - `provider_id` string
  - `message_id` string, required
  - `to` string, required
  - `subject` string, required
  - `created_at` string, date-time, required
  - `note` string, required

## Other responses

- `400`: Structured API error
- `401`: Structured API error
- `403`: Structured API error
- `404`: Structured API error
- `409`: Structured API error
- `429`: Wait Retry-After seconds; minute, hourly or UTC daily window applies
- `502`: Structured API error
- `503`: Structured API error

---

[API](https://skmtc.dev/agentaddress/apis/agentaddress-api.md) · [All operations](https://skmtc.dev/agentaddress/apis/agentaddress-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentaddress/apis/agentaddress-api/revisions/e41b8c27b4ca?raw)