Send Email (Agent Inboxes)
How to send emails through the Agentry API.
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