发送邮件
检查参数、发送并追踪事务邮件。
发件地址必须是已认领的收件箱地址,或已验证发件的域名下的地址。请求使用 Authorization: Bearer $MAILLY_API_KEY 鉴权。
curl https://api.mailly.site/send-email \
-H "Authorization: Bearer $MAILLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"fromEmail": "your-inbox@mailly.site",
"to": "you@example.com",
"subject": "Hello from my agent",
"text": "Your first email is ready.",
"dryRun": true
}'dryRun 只检查参数,不发送、不扣费。参数确认无误后:
- 核对通用余额或套餐邮件封数。
- 移除
dryRun正式发送。 - 在发件箱查看结果。请求被接受不代表最终送达,最终状态以投递事件为准。
不要自动重试结果未知的直接发件请求,先核对发件箱,否则可能重复发出同一封邮件。
多收件人发送和 Campaign 会进入队列并返回任务 ID,可用 Get batch task status 查询。
其他发送方式
- SMTP:接入现有邮件库。
- CLI 中的
mailly send。 - Remote MCP 中的
mailly_send_email,总是先用dry_run检查。
全部字段见 Send email 接口参考。