neynar-inbox
Email for AI agents. Create mailboxes, send and receive emails via API. No browser, no OAuth.
- License 许可
- MIT
- 最近更新
- 2026-06-10
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- neynar-inbox
- metadata
- { "tags": [ "email", "api", "agents", "inbox", "messaging" ], "author": "neynar", "homepage": "https://email.neynar.ai" }
- requires
- { "bins": [ "curl" ] }
- description
- Email for AI agents. Create mailboxes, send and receive emails via API. No browser, no OAuth.
03 SKILL.md 正文
Neynar Inbox
Email service built for AI agents. Create a mailbox, get an API key, send and receive real emails - all via REST API.
Quick Start
1. Create a mailbox (no auth needed)
curl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/mailboxes \
-H "Content-Type: application/json" \
-d '{"displayName": "My Agent", "username": "myagent"}'
Response:
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"address": "myagent@inbox.neynar.ai",
"apiKey": "fi_abc123...",
"warning": "Store the apiKey securely - it cannot be retrieved again."
}
CRITICAL: Store the apiKey immediately. It is only returned once and cannot be recovered.
Username is optional (random address if omitted). Must be at least 6 characters, alphanumeric with dots/hyphens/underscores.
2. Send an email
curl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/emails \
-H "Authorization: Bearer fi_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"to": ["recipient@example.com"],
"subject": "Hello from my agent",
"text": "This email was sent by an AI agent!"
}'
3. Check inbox
curl https://neynar-inbox-api.rish-68c.workers.dev/v1/emails?direction=inbound \
-H "Authorization: Bearer fi_your_api_key"
RECOMMENDED: If you have heartbeat, cron, or scheduling capabilities, set up polling (every 30-60 seconds) right after creating your mailbox to catch replies.
4. Search emails
curl "https://neynar-inbox-api.rish-68c.workers.dev/v1/search?q=invoice" \
-H "Authorization: Bearer fi_your_api_key"
API Reference
Base URL: https://neynar-inbox-api.rish-68c.workers.dev/v1
Authentication: Authorization: Bearer <api_key> (all endpoints except mailbox creation)
| Method | Endpoint | Description |
|---|---|---|
| POST | /v1/mailboxes | Create mailbox (no auth, returns apiKey) |
| GET | /v1/mailboxes | List your mailbox |
| DELETE | /v1/mailboxes/:id | Delete mailbox |
| POST | /v1/mailboxes/:id/rotate | Rotate API key |
| POST | /v1/emails | Send email |
| GET | /v1/emails | List emails (?limit=50&offset=0&direction=inbound) |
| GET | /v1/emails/:id | Get single email |
| DELETE | /v1/emails/:id | Delete email |
| GET | /v1/search?q=query | Full-text search |
| POST | /v1/webhooks | Register webhook |
| GET | /v1/webhooks | List webhooks |
| DELETE | /v1/webhooks/:id | Remove webhook |
Email Object
{
"id": "uuid",
"direction": "inbound",
"from": "sender@example.com",
"to": ["recipient@example.com"],
"subject": "Email subject",
"bodyText": "Plain text body",
"bodyHtml": "<p>HTML body</p>",
"status": "received",
"createdAt": "2024-01-15T10:00:00Z"
}
Webhooks
Register a webhook for real-time email notifications:
curl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/webhooks \
-H "Authorization: Bearer fi_your_api_key" \
-H "Content-Type: application/json" \
-d '{"url": "https://your-server.com/webhook", "events": ["email.received"]}'
Verify signatures via X-Webhook-Signature header (HMAC-SHA256 of body).
Error Codes
| Code | Description |
|---|---|
| 400 | Bad request |
| 401 | Unauthorized - missing or invalid API key |
| 403 | Forbidden |
| 404 | Not found |
| 409 | Username already taken |
| 500 | Server error |
Limits
- 3 mailboxes per account
04 同仓库更多 Skills
youtube-content
YouTube transcripts to summaries, threads, blogs.
xurl
X/Twitter via xurl CLI: post, search, DM, media, v2 API.
touchdesigner-mcp
Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
teams-meeting-pipeline
Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.