Send Email (Agent Inboxes)

How to send emails through the Agentry API.

View as Markdown

Basic Send

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:

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

With Attachments

{
  "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