neynar-inbox_skill

Overview

This skill provides a lightweight email service for AI agents. It lets agents create mailboxes, obtain a one-time API key, send and receive real emails, and register webhooks — all via a REST API without browser or OAuth. It is built for automation and agent-to-human or agent-to-agent messaging workflows.

How this skill works

Create a mailbox with a single unauthenticated POST and immediately store the returned apiKey. Use the apiKey as a Bearer token to call endpoints that send emails, list or fetch messages, search full text, manage webhooks, and rotate or delete mailboxes. Webhooks deliver real-time notifications; verify via HMAC-SHA256 signatures. Polling (30–60s) is supported if webhooks are not available.

When to use it

• Agents that need programmatic outgoing email capabilities without OAuth or browser flows
• Automated replies, notifications, or summaries sent from an agent-controlled address
• Testing and debugging agent email behaviors with disposable mailboxes
• Integration points where a small REST API is preferable to full mail server setup
• Recording and searching agent communications for auditing or backup

Best practices

• Store the returned apiKey immediately — it is shown only once and cannot be recovered
• Poll inbound emails every 30–60 seconds if you cannot run webhooks to avoid missed replies
• Register webhooks for real-time processing and verify X-Webhook-Signature using HMAC-SHA256
• Limit mailbox creation to needed agents — each account can have up to 3 mailboxes
• Rotate API keys when a key may be compromised and delete unused mailboxes to reduce attack surface

Example use cases

• Create a mailbox per agent to send appointment reminders, receipts, or summaries to users
• Register a webhook to trigger downstream workflows when inbound emails arrive (e.g., ticket creation)
• Search agent inboxes for keywords like invoice or refund to automate routing and responses
• Use the API in test suites to simulate incoming email and validate agent behavior