---
title: Send Email (Agent Inboxes)
description: How to send emails through the Agentry API.
surface: agent
---

## Basic Send

```bash
curl -X POST https://api.agentry.to/agent/v0/inboxes/{inbox_id}/messages/send \
  -H "Authorization: Bearer ag_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["recipient@example.com"],
    "subject": "Hello from my agent",
    "text": "Plain text content"
  }'
```

## With HTML

Include both `text` and `html` for maximum compatibility:

```json
{
  "to": ["recipient@example.com"],
  "subject": "Hello",
  "text": "Plain text fallback",
  "html": "<h1>Hello</h1><p>HTML content</p>"
}
```

## With Attachments

```json
{
  "to": ["recipient@example.com"],
  "subject": "Report attached",
  "text": "Please find the report attached.",
  "attachments": [
    {
      "filename": "report.pdf",
      "content": "base64-encoded-content",
      "content_type": "application/pdf"
    }
  ]
}
```

## Rate Limits

Sending is rate-limited by your plan's daily send limit. When exceeded, you'll receive a `429 Too Many Requests` response.

## Reply and Forward

- Reply: `POST /agent/v0/inboxes/{inbox_id}/messages/{message_id}/reply`
- Reply all: `POST /agent/v0/inboxes/{inbox_id}/messages/{message_id}/reply-all`
- Forward: `POST /agent/v0/inboxes/{inbox_id}/messages/{message_id}/forward`