skills.rest
zester4
zester4COMMUNITY
Explore all skills by this author →
GitHub

agentmail

Create and manage email inboxes for AI agents using the AgentMail API.

2|1|Updated Jun 9, 2026
Search Tags:#sdk#ai agents#email#inbox#websockets#webhooks#agentmail
One-click install
npx skills add https://github.com/zester4/zilmate --skill agentmail-zester4
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentmail
Source: https://github.com/zester4/zilmate/tree/main/.agents/skills/agentmail
Command: npx skills add https://github.com/zester4/zilmate --skill agentmail-zester4

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires agentmail, and includes references (resource) components.

What problem does it solve? AI agents often need their own email addresses to send, receive, and organize messages programmatically, but traditional email services are not designed for autonomous agent workflows. This Skill provides the AgentMail SDK patterns to give agents dedicated inboxes with full message, thread, and attachment handling. ## Core Features & Use Cases - Inbox and Message Management: Create inboxes on-demand, send and reply to emails with text and HTML bodies, and organize conversations with threads and labels. - Attachments, Drafts, and Pods: Send Base64-encoded attachments, create drafts for human-in-the-loop approval, and isolate customers with multi-tenant pods. - Real-Time Events: Receive email events via webhooks with HMAC signature verification or persistent WebSocket connections without a public URL. - Use Case: Build a support agent that receives customer emails in its own inbox, drafts replies for human approval, and gets notified in real time when new messages arrive. ## Quick Start Install the agentmail package, initialize the client with your API key, and ask the agent to create an inbox and send a test email with both text and HTML bodies.

Frequently Asked Questions about agentmail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I give an AI agent its own email inbox?▼

Install the agentmail SDK, initialize the client with your API key, and call client.inboxes.create() to provision an inbox with an auto-generated or custom address. The agent can then send, receive, and reply to messages from that inbox.

How do I receive email events in real time with AgentMail?▼

Use webhooks when you have a public URL, registering an endpoint with event types like message.received. For local development without a public URL, connect via the WebSocket API and subscribe to specific inboxes or pods.

Does AgentMail support multi-tenant SaaS applications?▼

Yes, AgentMail provides pods for multi-tenant isolation. Create a pod per customer with a clientId, then create and list inboxes scoped to that pod so each customer's email stays separated.

How do I verify AgentMail webhook signatures?▼

Compute an HMAC-SHA256 hex digest of the raw request body using your webhook secret and compare it to the X-AgentMail-Signature header with a timing-safe comparison. Reject requests with missing or mismatched signatures.

Can I create email drafts for human approval before sending?▼

Yes, use client.inboxes.drafts.create to compose a message without sending it. A human can review the draft, then call drafts.send to convert it into a sent message.

How do I retry inbox creation without duplicates?▼

Pass a unique clientId when creating an inbox. Retrying the request with the same clientId returns the original inbox instead of creating a duplicate, making create operations idempotent.

Related Skills

Explore More Software Engineering Skills→
greenflash-aigreenflash-ai

greenflash-verify

Verify Greenflash integration configuration and data flow for Python and TypeScript projects.

Official
Advanced
openaiopenai
5.3k

twilio-sendgrid-inbound-parse

Receive inbound email via SendGrid Inbound Parse webhooks with MX record setup and attachment handling.

Official
Intermediate
ebecerra-developerebecerra-developer

resend

Send, receive, and manage transactional emails through the Resend API.

Community
Advanced
carterwayneskhizeinecarterwayneskhizeine
19

agentmail

Create agent-owned email inboxes, send messages, and read threads via AgentMail API.

Community
Intermediate