Neynar 收件箱

为AI代理构建的电子邮件服务。创建邮箱、获取API密钥、发送和接收真实邮件——全部通过REST API实现。

快速开始

1. 创建邮箱（无需认证）

bash
curl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/mailboxes \
-H Content-Type: application/json \
-d {displayName: 我的代理, username: myagent}

响应：
json
{
id: 550e8400-e29b-41d4-a716-446655440000,
address: myagent@inbox.neynar.ai,
apiKey: fi_abc123...,
warning: 请安全存储apiKey——它无法再次获取。
}

关键提示：立即存储apiKey。它仅返回一次，且无法恢复。

用户名为可选（省略则生成随机地址）。至少6个字符，支持字母数字及点号/连字符/下划线。

2. 发送邮件

bash
curl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/emails \
-H Authorization: Bearer fiyourapi_key \
-H Content-Type: application/json \
-d {
to: [recipient@example.com],
subject: 来自我的代理的问候,
text: 这封邮件由AI代理发送！
}

3. 查看收件箱

bash
curl https://neynar-inbox-api.rish-68c.workers.dev/v1/emails?direction=inbound \
-H Authorization: Bearer fiyourapi_key

推荐：如果你有心跳、定时任务或调度功能，请在创建邮箱后立即设置轮询（每30-60秒）以捕获回复。

4. 搜索邮件

bash
curl https://neynar-inbox-api.rish-68c.workers.dev/v1/search?q=发票 \
-H Authorization: Bearer fiyourapi_key

API参考

基础URL：https://neynar-inbox-api.rish-68c.workers.dev/v1

认证方式：Authorization: Bearer （除创建邮箱外的所有端点）

邮件对象

json
{
id: uuid,
direction: inbound,
from: sender@example.com,
to: [recipient@example.com],
subject: 邮件主题,
bodyText: 纯文本正文,
bodyHtml:

HTML正文

Webhook

注册Webhook以接收实时邮件通知：

bash
curl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/webhooks \
-H Authorization: Bearer fiyourapi_key \
-H Content-Type: application/json \
-d {url: https://your-server.com/webhook, events: [email.received]}

通过X-Webhook-Signature标头验证签名（对正文进行HMAC-SHA256）。

错误码

限制

• - 每个账户3个邮箱