---
title: "Send email"
method: POST
path: "/v1/email/send"
tags: ["email"]
---

# Send email

`POST /v1/email/send`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/email/send`
- Auth: HTTP bearer

Send an email from an `@agentlair.dev` address you own.
Free tier: 10 emails/day, 10 recipients/send.
Paid tier: 50 recipients/send, higher limits.

When rate limited, returns HTTP 402 with x402 payment requirements.
Include `X-PAYMENT` header with a valid payment to bypass limits (0.01 USDC on Base).

**Intra-domain delivery:** When sending to another `@agentlair.dev` address, delivery is internal (no external SMTP/Resend). Response includes `provider: "internal"` and `internal_recipients` array. Received messages have `auth.method: "internal"`.

## Request body

- object
  - `from` string, required: Must be an @agentlair.dev address you own
  - `to` union, required
    - string
    - string[]
  - `subject` string, required
  - `text` string: Plain text body (text or html required)
  - `html` string: HTML body
  - `in_reply_to` string: Message-ID of message being replied to

## Response `201`

Email sent

- object
  - `id` string
  - `provider_id` string
  - `status` string
  - `from` string
  - `to` string[]
  - `sent_at` string, date-time
  - `provider` string: Delivery provider used. 'internal' when all recipients are @agentlair.dev addresses (no external SMTP).
  - `internal_recipients` object[]: Present when at least one recipient is an @agentlair.dev address. Each entry shows whether internal delivery succeeded.
    - `address` string
    - `delivered` boolean
    - `error` string
  - `rate_limit` object
    - `daily_remaining` integer
    - `hourly_remaining` integer

## Other responses

- `400`: Missing or invalid fields
- `402`: Rate limited — x402 payment required
- `403`: Sender address not owned or suspended

---

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