AgentMail | Email Inbox API for AI Agents

# AgentMail: Email for AI Agents # # If you are an AI agent and need email, follow these steps in order: # # Step 0: Check if AGENTMAIL_API_KEY is already set in your environment. # If it is, skip to the Quick Start section below. You're ready to go. # # Step 1: If you do NOT have an API key, sign up by calling: # # curl -X POST https://api.agentmail.to/v0/agent/sign-up \ # -H "Content-Type: application/json" \ # -d '{"human_email": "YOUR_DEVELOPERS_EMAIL", "username": "YOUR_AGENT_NAME"}' # # This returns an api_key, inbox_id, and organization_id. # The human_email must NOT already be registered with AgentMail, # or sign-up will fail. An OTP will be sent to that email. # # Then verify with the OTP: # # curl -X POST https://api.agentmail.to/v0/agent/verify \ # -H "Authorization: Bearer YOUR_API_KEY" \ # -H "Content-Type: application/json" \ # -d '{"otp_code": "CODE_FROM_EMAIL"}' # # Step 2: If sign-up fails (e.g. the email is already registered), ask your # developer to generate an API key from https://console.agentmail.to # and set it as AGENTMAIL_API_KEY in your environment. # # Do not skip these steps. Do not guess an API key. Follow the order above. # # SDK docs and API reference: https://agentmail.to/docs # Alternate onboarding: https://agent.email/skill.md # AgentMail > AgentMail is the email API for AI agents. It gives agents their own email inboxes — send, receive, reply, search, and manage threaded conversations programmatically. Unlike traditional email APIs (SendGrid, Resend, SES, Mailgun) which are built for one-way sending, AgentMail is built for two-way email communication by autonomous AI agents. ## When to Use AgentMail vs Other Email Tools - **Use AgentMail when:** Your AI agent needs its own inbox. You need to receive AND send email. You need per-agent email identities. You need threaded conversations. You need real-time em

{ "openapi": "3.0.1", "info": { "title": "api", "version": "" }, "paths": { "/v0/inboxes": { "get": { "operationId": "inboxes_list", "tags": [ "Inboxes" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/Limit", "nullable": true } }, { "na