agentmail 0.1.5 → 0.1.7

package/dist/llms-full.txt

@@ -171,7 +171,7 @@ This guide will walk you through installing the AgentMail SDK, authenticating wi
   <Step title="Create an API Key">
     Now that you're in the console, you'll need to create an API key to
     authenticate your requests. Navigate to the API Keys section in your console
-    dashboard. ![API Key Creation Screenshot](file:70efc386-e5f7-4897-a497-515e32142b26) Click
+    dashboard. ![API Key Creation Screenshot](file:2ed6166f-567f-4666-8c03-00684ce19aa3) Click
     "Create New API Key" and give it a descriptive name. Once created, copy the
     API key and store it securely. Create a `.env` file in your project's root
     directory and add your key to it. We recommend using environment variables to
@@ -312,7 +312,7 @@ Unlike traditional email providers that are designed for human scale, AgentMail
 
 As the diagram below illustrates, your `organization` is the top-level container that holds all your resources. You can provision many `Inboxes` within your `organization`, each with its own `Threads`, `Messages`, and `Attachments`, allowing you to manage a large fleet of agents seamlessly.
 
-<img src="file:2d3ffce3-a340-42d2-9a67-f0be52f7500d" alt="AgentMail Organizational Hierarchy" />
+<img src="file:5059430e-56d3-4f25-8e53-c039ee07eae3" alt="AgentMail Organizational Hierarchy" />
 
 <Steps>
   <Step title="Organization">
@@ -732,7 +732,7 @@ Here is an example of a well-structured and styled HTML header:
 </CodeBlocks>
 
 <Frame caption="Look how pretty this message looks!">
-  <img src="file:42af328f-ce02-484c-a5b5-1566ac786ee2" alt="rendered css" />
+  <img src="file:c026b6cd-f41d-4bc0-9818-5058474f4b79" alt="rendered css" />
 </Frame>
 
 ## Receiving `Messages`
@@ -1507,6 +1507,256 @@ Pod: "Marketing-Agent"
 * Explore [Domains](/custom-domains) to set up custom email domains for your pods
 
 
+# Integrations
+
+> Overview of AgentMail's integrations
+
+## Platforms
+
+<CardGroup>
+  <Card title="Replit" icon="fa-solid fa-box-open" href="replit" />
+
+  <Card title="Smithery" icon="fa-solid fa-box-open" href="smithery" />
+</CardGroup>
+
+## Frameworks
+
+<CardGroup>
+  <Card title="Mastra" icon="fa-solid fa-box-open" href="mastra" />
+
+  <Card title="CrewAI" icon="fa-solid fa-box-open" href="crewai" />
+</CardGroup>
+
+
+# Replit
+
+> AgentMail's Replit integration
+
+## Getting started
+
+Replit is a cloud-based app and agent builder with a built in IDE, AI assistant, and deployment infrastructure.
+
+AgentMail is a "connector" integration on Replit, meaning your Replit apps and agents can use it directly.
+
+### Setup
+
+Navigate to the Intregrations tab in the Replit builder. Find AgentMail and click Connect/Sign in. Then paste in your AgentMail API key from the AgentMail Console. That's it.
+
+## How it works
+
+Replit uses Mastra, a TypeScript framework for building agents. Everytime you create a new app/agent Replit will generate a set of Mastra tools to interface with the AgentMail API, based on your use case and requirements.
+
+Below is a collections of prebuilt tools that Replit can use out of the box to serve virtually any use case.
+
+### Tools
+
+<CodeBlocks>
+  ```typescript title="TypeScript"
+  import { createTool } from '@mastra/core/tools'
+  import { z } from 'zod'
+
+  import { AgentMailClient } from 'agentmail'
+
+  const ListItemsInput = z.object({
+      limit: z.number().optional().describe('Max number of items to return'),
+      pageToken: z.string().optional().describe('Pagination page token'),
+  })
+
+  const InboxId = z.string().describe('ID of inbox')
+
+  const GetInboxInput = z.object({ inboxId: InboxId })
+
+  const CreateInboxInput = z.object({
+      username: z.string().optional().describe('Username'),
+      domain: z.string().optional().describe('Domain'),
+      displayName: z.string().optional().describe('Display name'),
+  })
+
+  const ListInboxItemsInput = ListItemsInput.extend({
+      inboxId: InboxId,
+      labels: z.array(z.string()).optional().describe('Filter items with labels'),
+      before: z.coerce.date().optional().describe('Filter items before datetime'),
+      after: z.coerce.date().optional().describe('Filter items after datetime'),
+  })
+
+  const GetThreadInput = GetInboxInput.extend({
+      threadId: z.string().describe('ID of thread'),
+  })
+
+  const MessageId = z.string().describe('ID of message')
+
+  const BaseMessageInput = z.object({
+      inboxId: InboxId,
+      text: z.string().optional().describe('Plain text body'),
+      html: z.string().optional().describe('HTML body'),
+      labels: z.array(z.string()).optional().describe('Labels'),
+  })
+
+  const SendMessageInput = BaseMessageInput.extend({
+      to: z.union([z.string(), z.array(z.string())]).describe('To recipients'),
+      cc: z
+          .union([z.string(), z.array(z.string())])
+          .optional()
+          .describe('CC recipients'),
+      bcc: z
+          .union([z.string(), z.array(z.string())])
+          .optional()
+          .describe('BCC recipients'),
+  })
+
+  const ReplyToMessageInput = BaseMessageInput.extend({ messageId: MessageId })
+
+  const UpdateMessageInput = z.object({
+      inboxId: InboxId,
+      messageId: MessageId,
+      addLabels: z.array(z.string()).optional().describe('Labels to add'),
+      removeLabels: z.array(z.string()).optional().describe('Labels to remove'),
+  })
+
+  const listInboxesTool = createTool({
+      id: 'list-inboxes',
+      description: 'List inboxes',
+      inputSchema: ListItemsInput,
+      execute: ({ context }) => {
+          const client = new AgentMailClient()
+          return client.inboxes.list(context)
+      },
+  })
+
+  const createInboxTool = createTool({
+      id: 'create-inbox',
+      description: 'Create inbox',
+      inputSchema: CreateInboxInput,
+      execute: ({ context }) => {
+          const client = new AgentMailClient()
+          return client.inboxes.create(context)
+      },
+  })
+
+  const deleteInboxTool = createTool({
+      id: 'delete-inbox',
+      description: 'Delete inbox',
+      inputSchema: GetInboxInput,
+      execute: ({ context }) => {
+          const client = new AgentMailClient()
+          return client.inboxes.delete(context.inboxId)
+      },
+  })
+
+  const listThreadsTool = createTool({
+      id: 'list-threads',
+      description: 'List threads',
+      inputSchema: ListInboxItemsInput,
+      execute: ({ context }) => {
+          const client = new AgentMailClient()
+          return client.inboxes.threads.list(context.inboxId, context)
+      },
+  })
+
+  const getThreadTool = createTool({
+      id: 'get-thread',
+      description: 'Get thread and its messages',
+      inputSchema: GetThreadInput,
+      execute: ({ context }) => {
+          const client = new AgentMailClient()
+          return client.inboxes.threads.get(context.inboxId, context.threadId)
+      },
+  })
+
+  const sendMessageTool = createTool({
+      id: 'send-message',
+      description: 'Send message',
+      inputSchema: SendMessageInput,
+      execute: ({ context }) => {
+          const client = new AgentMailClient()
+          return client.inboxes.messages.send(context.inboxId, context)
+      },
+  })
+
+  const replyToMessageTool = createTool({
+      id: 'reply-to-message',
+      description: 'Reply to message',
+      inputSchema: ReplyToMessageInput,
+      execute: ({ context }) => {
+          const client = new AgentMailClient()
+          return client.inboxes.messages.reply(context.inboxId, context.messageId, context)
+      },
+  })
+
+  const updateMessageTool = createTool({
+      id: 'update-message',
+      description: 'Update message',
+      inputSchema: UpdateMessageInput,
+      execute: ({ context }) => {
+          const client = new AgentMailClient()
+          return client.inboxes.messages.update(context.inboxId, context.messageId, context)
+      },
+  })
+
+  export const tools = {
+      listInboxesTool,
+      createInboxTool,
+      deleteInboxTool,
+      listThreadsTool,
+      getThreadTool,
+      sendMessageTool,
+      replyToMessageTool,
+      updateMessageTool,
+  }
+  ```
+</CodeBlocks>
+
+## About AgentMail
+
+AgentMail is the email inbox API for AI agents. It gives agents their own email inboxes, like Gmail does for humans. Unlike other email APIs, AgentMail is for both sending and receiving, supporting two-way email conversations.
+
+Email is critical to identity and communication on the internet. Much of the context that people use for their work exists within email. AgentMail enables AI agents to meet people where they work and use the internet like humans do.
+
+### Features
+
+1. **Programmatic inboxes:** Create, manage, and delete inboxes via API
+2. **Threads and replies:** Facilitate 2-way emals conversations with persistant and relevant context
+3. **Attachments:** Send, receive, and download attachments so agents can work with documents
+4. **Realtime events:** Build event-driven agents and systems with Webhooks and Websockets
+5. **Custom domains:** Whitelabel your or your customers' inboxes to automate client-facing work
+6. **Language/Framework SDKs:** Use your prefered language and framework
+
+### Use cases
+
+1. **Process inbound:** Receive, triage, and process inbound emails
+2. **Automate outbound:** Draft, schedule, and send outbound emails
+3. **Join conversations:** Address an agent directly or CC it in an existing email thread
+4. **Identify and authenticate:** Agents can sign up, receive 2FA code, and authenticate with any application
+
+### Verticals
+
+1. **Operations:** Automate internal workflows, vendor communications, and cross-team coordination
+2. **Support:** Handle customer inquiries, ticket management, and automated responses at scale
+3. **Procurement:** Streamline vendor onboarding, RFP processes, and purchase order management
+4. **Sales:** Automate lead qualification, follow-ups, and customer outreach campaigns
+5. **Recruiting:** Automate candidate outreach, interview scheduling, and applicant communication
+
+These are just a few select verticals, but we have seen AgentMail be effective in automating any email task across every function. If a human does it with email, it can be automated with AgentMail.
+
+
+# Smithery
+
+> AgentMail's Smithery integration
+
+
+
+# Mastra
+
+> AgentMail's Mastra integration
+
+
+
+# CrewAI
+
+> AgentMail's CrewAI integration
+
+
+
 # Guide: Sending & Receiving Email
 
 > A step-by-step guide to the practical workflow of sending initial emails and handling replies to have a full conversation.
@@ -1759,7 +2009,7 @@ Configuring your domain is a three-step process: add the domain via API, copy th
     After creating your domain in the AgentMail Console, click the "Download BIND Zone File" button to get the complete zone file.
 
     <Frame caption="Downloading BIND zone file from AgentMail Console">
-      <img src="file:b3ff2a02-c596-4554-be3d-1e54811dfa55" alt="Download BIND Zone File from Console" />
+      <img src="file:abd861e7-e3c4-4253-843d-5e1877e84487" alt="Download BIND Zone File from Console" />
     </Frame>
 
     <Tabs>
@@ -1770,13 +2020,13 @@ Configuring your domain is a three-step process: add the domain via API, copy th
         2. Click **"Import zone file"** in the top right corner
 
         <Frame caption="Importing BIND zone file in AWS Route 53">
-          <img src="file:e7101e7a-5590-4fe1-b1d4-733c24ec310f" alt="AWS Route 53 BIND Import" />
+          <img src="file:1381b9e1-8945-463b-8211-f3cb7d8ff390" alt="AWS Route 53 BIND Import" />
         </Frame>
 
         3. Paste the CONTENTS of downloaded BIND zone file
 
         <Frame caption="Open the file with text editor and paste the contents. It should look similar to what we have in this image.">
-          <img src="file:fe2e9d0f-f350-479c-b634-5477599d3053" alt="AWS Route 53 BIND Import" />
+          <img src="file:a1ec7b55-2283-4e6c-af6f-5bfca7ad00d6" alt="AWS Route 53 BIND Import" />
         </Frame>
 
         4. Review the records and click **"Import"**
@@ -1789,13 +2039,13 @@ Configuring your domain is a three-step process: add the domain via API, copy th
         2. Navigate to **DNS > Records**
 
         <Frame caption="This is what the page looks like">
-          <img src="file:b8cfed63-5fea-420f-ac7f-9731a80e840d" alt="Cloudflare BIND Import" />
+          <img src="file:ba36964f-3f3e-439c-80f0-c71884757f68" alt="Cloudflare BIND Import" />
         </Frame>
 
         3. Click **"Import and Export"**
 
         <Frame caption="You should be able to just drop the file in">
-          <img src="file:d8762904-358d-432e-99cf-4e4b4763fed5" alt="Cloudflare BIND Import" />
+          <img src="file:990c0430-f086-4365-813f-a3b6463d5e07" alt="Cloudflare BIND Import" />
         </Frame>
 
         4. Upload the downloaded BIND zone file as is
@@ -1808,13 +2058,13 @@ Configuring your domain is a three-step process: add the domain via API, copy th
         2. Navigate to the **DNS** subtab of the domain you want to send from
 
         <Frame caption="Click on this button!">
-          <img src="file:58e638a2-7862-451e-9c69-2705ad1f6022" alt="Porkbun DNS Management" />
+          <img src="file:86a3ef0e-6f6e-4eb3-a721-52c1730f0b49" alt="Porkbun DNS Management" />
         </Frame>
 
         3. Scroll down to the quick upload section
 
         <Frame caption="Upload your BIND zone file here">
-          <img src="file:a33096b6-9f1c-40f0-9e3d-71c7aa850d30" alt="Porkbun Zone File Import" />
+          <img src="file:295db837-0235-4696-b96d-5318f68b49f5" alt="Porkbun Zone File Import" />
         </Frame>
 
         4. Upload the downloaded BIND zone file as is
@@ -1898,7 +2148,7 @@ Configuring your domain is a three-step process: add the domain via API, copy th
               * **Value:** Can directly copy paste the `value` from the API response (e.g., `{random_letters_numbers}.dkim.amazonses.com`).
 
             <Frame caption="Example of adding a CNAME record in Route 53. Notice that AWS already appends the root domain (agentmail.cc) to the end of the name value!">
-              <img src="file:b6048450-c831-4d87-96bf-7f62d837ef90" alt="AWS Route 53 Record Configuration" />
+              <img src="file:e57473d0-08bd-4ddc-ba64-0ff6c2e49ccc" alt="AWS Route 53 Record Configuration" />
             </Frame>
 
             * **TXT (DMARC/SPF):**
@@ -2008,7 +2258,7 @@ DNS can be tricky. Here are some common issues and how to resolve them.
 
 ## Best Practices for Domain Management
 
-Check out our guide on [Email Deliverability](/best-practices/email-deliverability) for tips on warming up your new domain and maintaining a healthy sender reputation.
+Check out our guide on [Email Deliverability](/email-deliverability) for tips on warming up your new domain and maintaining a healthy sender reputation.
 
 
 # Managing Your Domains
@@ -2434,13 +2684,13 @@ Ngrok creates a secure tunnel from a public URL to your local development server
 
 Visit [ngrok.com](https://ngrok.com/) and click "Sign up" to create a free account.
 
-<img src="file:2b9efd50-bc45-4c1d-be5d-0a0e2451fc05" alt="Ngrok homepage" />
+<img src="file:b2e9355e-36a9-46dc-bbe0-8192253fc301" alt="Ngrok homepage" />
 
 ### 1.2 Choose your platform and install
 
 After logging in, ngrok will guide you through the setup process. Select your operating system and follow the installation instructions.
 
-<img src="file:53878264-f22e-45d0-b6e5-3deace921b2d" alt="Ngrok setup instructions" />
+<img src="file:3905deb7-315f-48fe-adee-1f4e4a115bcd" alt="Ngrok setup instructions" />
 
 For macOS, you can install ngrok via Homebrew:
 
@@ -2486,7 +2736,7 @@ ngrok http 3000
 
 You should see output similar to this:
 
-<img src="file:da7bae5a-8b4d-4657-9da6-ffe312457580" alt="Ngrok terminal output" />
+<img src="file:96fe265e-bc8e-40fc-8bb1-a53acadb74ca" alt="Ngrok terminal output" />
 
 Copy the **Forwarding URL** (e.g., `https://your-subdomain.ngrok-free.app`). This is the public URL that AgentMail will use to send webhooks.
 
@@ -2583,7 +2833,7 @@ python webhook_receiver.py
 
 Open your browser and visit `http://127.0.0.1:3000` to see the status page confirming your webhook receiver is running:
 
-<img src="file:a246e89b-1dc2-4f91-b1b7-ebe6527efb10" alt="Webhook receiver status page" />
+<img src="file:6e602847-1e91-47d2-8aa0-c4d8ca72fed4" alt="Webhook receiver status page" />
 
 ## Testing Your Setup
 
@@ -2705,7 +2955,7 @@ How you send your emails is just as important as what you send. If you're sendin
     more natural to email providers. AgentMail's ability to create inboxes at
     scale makes this strategy easy to implement.
 
-    <img src="file:1c500820-48d4-480b-8df5-7f6b0c12fc34" alt="Diagram comparing one inbox sending 1000 emails vs. five inboxes sending 200 each." />
+    <img src="file:d79176d8-08fb-4eba-b880-66bfcf164f59" alt="Diagram comparing one inbox sending 1000 emails vs. five inboxes sending 200 each." />
   </Step>
 
   <Step title="Protect Your Reputation with Multiple Domains">
@@ -3293,6 +3543,7 @@ Create a file named `agent.py` and paste the following code:
   from flask import Flask, request, Response
   import ngrok
   from agentmail import AgentMail
+  import threading
 
   # Configuration
   PORT = 8080
@@ -3302,6 +3553,7 @@ Create a file named `agent.py` and paste the following code:
   # Initialize Flask app and AgentMail client
   app = Flask(__name__)
   client = AgentMail()
+  processed_messages = set()  # Track processed message IDs to prevent duplicates
 
 
   def setup_agentmail():
@@ -3334,6 +3586,7 @@ Create a file named `agent.py` and paste the following code:
           webhook = client.webhooks.create(
               url=f"{listener.url()}/webhook/agentmail",
               event_types=["message.received"],
+              inbox_ids=[inbox.inbox_id],
               client_id=f"{INBOX_USERNAME}-webhook"
           )
           print(f"✓ Webhook created")
@@ -3361,25 +3614,8 @@ Create a file named `agent.py` and paste the following code:
       )
 
 
-  @app.route('/webhook/agentmail', methods=['POST'])
-  def receive_webhook():
-      """Webhook endpoint to receive incoming email notifications."""
-      payload = request.json
-      event_type = payload.get('type') or payload.get('event_type')
-
-      # Ignore outgoing messages
-      if event_type == 'message.sent':
-          return Response(status=200)
-
-      message = payload.get('message', {})
-      message_id = message.get('message_id')
-      inbox_id = message.get('inbox_id')
-      from_field = message.get('from_', '') or message.get('from', '')
-
-      # Validate required fields
-      if not message_id or not inbox_id or not from_field:
-          return Response(status=200)
-
+  def process_and_reply(message_id, inbox_id, from_field, subject, message):
+      """Process incoming message and send reply in background."""
       # Extract sender email and name
       if '<' in from_field and '>' in from_field:
           sender_email = from_field.split('<')[1].split('>')[0].strip()
@@ -3390,10 +3626,8 @@ Create a file named `agent.py` and paste the following code:
           sender_email = from_field.strip()
           sender_name = sender_email.split('@')[0].title() if '@' in sender_email else 'Friend'
 
-      subject = message.get('subject', '(no subject)')
-
       # Log incoming email
-      print(f"Email from {sender_email}: {subject}")
+      print(f"Processing email from {sender_email}: {subject}")
 
       # Generate and send auto-reply
       try:
@@ -3408,6 +3642,41 @@ Create a file named `agent.py` and paste the following code:
       except Exception as e:
           print(f"Error: {e}\n")
 
+
+  @app.route('/webhook/agentmail', methods=['POST'])
+  def receive_webhook():
+      """Webhook endpoint to receive incoming email notifications."""
+      payload = request.json
+      event_type = payload.get('type') or payload.get('event_type')
+
+      # Ignore outgoing messages
+      if event_type == 'message.sent':
+          return Response(status=200)
+
+      message = payload.get('message', {})
+      message_id = message.get('message_id')
+      inbox_id = message.get('inbox_id')
+      from_field = message.get('from_', '') or message.get('from', '')
+
+      # Validate required fields
+      if not message_id or not inbox_id or not from_field:
+          return Response(status=200)
+
+      # prevent duplicate
+      if message_id in processed_messages:
+          return Response(status=200)
+      processed_messages.add(message_id)
+
+      subject = message.get('subject', '(no subject)')
+
+      # Process in background thread and return immediately
+      thread = threading.Thread(
+          target=process_and_reply,
+          args=(message_id, inbox_id, from_field, subject, message)
+      )
+      thread.daemon = True
+      thread.start()
+
       return Response(status=200)
 
 
@@ -4705,7 +4974,7 @@ Done
 
 Go to your AgentMail inbox and filter by labels to organize your emails:
 
-<img src="file:879ff90e-9416-4b31-a009-2054c03d170d" alt="Test image" />
+<img src="file:19536629-9971-42f0-b8c1-ffa1f9849fd5" alt="Test image" />
 
 **Filter by sentiment:**
 
@@ -4875,12 +5144,545 @@ Ready to build your own intelligent email agent? Check out our [quickstart guide
 </AccordionGroup>
 
 
+# Email Reply Extraction with Talon
+
+> Learn how to use Talon to extract new content from email replies, removing quoted text with 93.8% accuracy.
+
+## Why Talon?
+
+Email threads accumulate quoted replies that clutter the actual content. When processing emails programmatically, you need just the new message, not the entire conversation history.
+
+**Talon solves this problem** by extracting clean reply content through sophisticated pattern matching and structural analysis.
+
+### Use Cases
+
+* **AI Email Agents**: Extract new user messages without processing entire thread history
+* **Email Automation**: Parse replies to identify actionable content
+* **Thread Analysis**: Build conversation flows by isolating individual contributions
+* **Inbox Management**: Process only new information from replies
+
+### Why Choose Talon?
+
+<CardGroup cols={2}>
+  <Card title="HTML Email Support" icon="fa-regular fa-file-code">
+    Handles Gmail, Outlook, Apple Mail, Thunderbird HTML structures
+  </Card>
+
+  <Card title="High Accuracy" icon="fa-regular fa-bullseye">
+    93.8% success rate across 64 real-world test cases
+  </Card>
+
+  <Card title="Multi-language" icon="fa-regular fa-globe">
+    Supports English, Japanese, Swedish, Polish, Dutch, German
+  </Card>
+
+  <Card title="Fast Performance" icon="fa-regular fa-gauge-high">
+    1.92ms average processing time, 488 emails/second
+  </Card>
+</CardGroup>
+
+***
+
+## How Talon Works
+
+Talon uses two complementary approaches depending on email format:
+
+### Plain Text Processing (6-Stage Pipeline)
+
+1. **Line Classification**: Assigns markers to each line ('t'=text, 'm'=quote marker, 's'=splitter, 'e'=empty)
+2. **Pattern Matching**: Applies regex to marker sequences to identify quoted blocks
+3. **Content Extraction**: Removes quoted lines and returns clean text
+
+Recognizes patterns like:
+
+* Standard quote markers (`>`)
+* Reply headers ("On \[date] \[name] wrote:")
+* Forward indicators ("-----Original Message-----")
+
+### HTML Processing (8-Stage Pipeline)
+
+1. **Structural Removal**: Directly removes known quotation elements (Gmail divs, blockquotes, Outlook markup)
+2. **Checkpoint Fallback**: For non-standard HTML, maps elements to text lines, applies text patterns, removes corresponding HTML
+
+### Processing Systems
+
+**Quotation Removal** (Primary)
+
+* Removes quoted replies from thread
+* No initialization required
+* Rule-based pattern matching
+
+***
+
+## Getting Started
+
+<Steps>
+  <Step title="Install Talon">
+    Install via pip with required workaround for Python 3.11+:
+
+    <CodeBlocks>
+      ```bash
+      pip install talon
+      ```
+    </CodeBlocks>
+  </Step>
+
+  <Step title="Apply Python 3.11+ Workaround">
+    Required fix for cchardet dependency:
+
+    <CodeBlocks>
+      ```python
+      # Import workaround BEFORE importing talon
+      import sys
+      import chardet
+      sys.modules['cchardet'] = chardet
+
+      # Now safe to import talon
+      import talon
+      from talon import quotations
+      ```
+    </CodeBlocks>
+
+    <Callout intent="warn">
+      This workaround is **required** for Python 3.11+.
+    </Callout>
+  </Step>
+
+  <Step title="Extract Reply Content">
+    Basic usage for plain text and HTML:
+
+    <CodeBlocks>
+      ```python title="Plain Text"
+      from talon import quotations
+
+      email = """Great work on the project!
+
+      On Mon, Apr 11, 2011 at 6:54 PM, Bob wrote:
+      > Can you review the document?
+      > Need feedback by Friday.
+      """
+
+      clean_reply = quotations.extract_from_plain(email)
+      # Result: "Great work on the project!"
+      ```
+
+      ```python title="HTML"
+      from talon import quotations
+
+      html_email = """
+      <html><body>
+      <div>Thanks for the update!</div>
+      <div class="gmail_quote">
+        <div>On Mon, Alice wrote:</div>
+        <blockquote>Original message here</blockquote>
+      </div>
+      </body></html>
+      """
+
+      clean_html = quotations.extract_from_html(html_email)
+      # Returns: <html><body><div>Thanks for the update!</div></body></html>
+      ```
+    </CodeBlocks>
+  </Step>
+</Steps>
+
+***
+
+## Performance & Accuracy
+
+Talon has been tested on 64 real-world emails from various clients and languages.
+
+### Test Results Summary
+
+| Metric                  | Value               |
+| ----------------------- | ------------------- |
+| **Total Tests**         | 64 emails           |
+| **Passed**              | 60 (93.8%)          |
+| **Failed**              | 4 (6.2%)            |
+| **Avg Processing Time** | 1.92ms              |
+| **Throughput**          | 488.6 emails/second |
+| **Min/Max Time**        | 0.13ms - 21.55ms    |
+
+### Test Coverage
+
+* **22 HTML emails**: Gmail, Outlook, Apple Mail, Thunderbird, Mail.ru, Hotmail
+* **42 plain text emails**: Various formats and reply styles
+* **6+ languages**: English, Japanese, Swedish, Polish, Dutch, German
+* **Mobile clients**: iPhone, Android "Sent from" signatures
+
+### Processing Time by Complexity
+
+| Email Type         | Avg Time  | Complexity |
+| ------------------ | --------- | ---------- |
+| Simple text reply  | 0.2-0.5ms | Low        |
+| HTML Gmail/Outlook | 2-4ms     | Medium     |
+| Complex threads    | 4-22ms    | High       |
+
+### Speed vs Accuracy Tradeoff
+
+| Library      | Avg Processing Time | Accuracy | Best For                                |
+| ------------ | ------------------- | -------- | --------------------------------------- |
+| **Talon**    | 1.92ms              | 93.8%    | Production systems needing HTML support |
+| qutoequail   | 0.96ms              | \~85%    | Moderate accuracy requirements          |
+| Custom regex | 0.1ms               | \~70%    | Simple plain text, speed critical       |
+
+**Insight**: For production systems, 1.92ms average is negligible. Even at worst case (21.55ms), Talon is faster than most network requests.
+
+***
+
+## Known Limitations
+
+Talon failed 4 out of 64 test cases. Here's what didn't work:
+
+<AccordionGroup>
+  <Accordion title="Failed Test Cases (4 total)">
+    ### Test Case 1: Complex Email Thread with Mixed Content
+
+    **Input**:
+
+    ```text
+    Thank you, Sonya Johnson.
+
+    I have sent an invite for 10:30am Monday PDT (today). I
+    hope you can join.
+
+    Regards,
+
+    Christopher Edwards
+
+
+    On Mon, Jun 3, 2024 at 12:53 AM Cody Hart <omerritt@example.com> wrote:
+
+    > Hi Christopher Edwards,
+    >
+    > 10.30 AM pacific is good for me.
+    >
+    > Thanks & Regards,
+    >
+    > Cody Hart
+    ```
+
+    **Expected Output**: First 5 lines only (up to `Christopher Edwards`)
+
+    **Talon's Output**: Returns entire email including quoted text starting with "On Mon, Jun 3..." and all "> quoted text"
+
+    **Processing Time**: 2.55ms
+
+    **Issue**: Signature placement before quotes confuses detection logic
+
+    ***
+
+    ### Test Case 2: Inline Responses
+
+    **Input**:
+
+    ```text
+    On Tue, Apr 29, 2014 at 4:22 PM, Example Dev <sugar@example.com> wrote:
+
+    > okay. Well, here's some stuff I can write.
+    >
+    > And if I write a 2 second line you and maybe reply under this?
+    >
+    > Or if you didn't really feel like it, you could reply under this line.
+
+    I will reply under this one
+
+    >
+    > okay?
+    >
+
+    and under this.
+
+    >
+    > -- Tim
+    ```
+
+    **Expected Output**: Just the inline responses (`I will reply under this one` and `and under this.`)
+
+    **Talon's Output**: Returns everything including "On Tue, Apr 29..." header and all quoted lines
+
+    **Processing Time**: 0.48ms
+
+    **Issue**: Interleaved inline responses not recognized as the reply pattern
+
+    ***
+
+    ### Test Case 3: Gmail Forward HTML
+
+    **Input**:
+
+    ```html
+    <html><head></head><body><div dir="ltr">test<div><br /></div><div>blah</div>
+    <div><br /><div class="gmail_quote">---------- Forwarded message ----------<br />
+    From: <b class="gmail_sendername">Foo Bar</b>
+    <span dir="ltr">&lt;<a href="mailto:foo@bar.example">foo@bar.example</a>&gt;</span><br />
+    Date: Thu, Mar 24, 2016 at 5:17 PM<br />
+    Subject: The Subject<br />
+    To: John Doe &lt;<a href="mailto:john@doe.example">john@doe.example</a>&gt;<br />
+    <br /><br /><div dir="ltr">Some text<div><br /></div><div><br /></div></div>
+    </div><br /></div></div></body></html>
+    ```
+
+    **Expected Output**: Just `testblah` (before the forward marker)
+
+    **Talon's Output**: Includes "---------- Forwarded message ----------" and forwarded content
+
+    **Processing Time**: 3.41ms
+
+    **Issue**: HTML forward headers not removed by Gmail quote detection
+
+    ***
+
+    ### Test Case 4: Thunderbird Forward HTML
+
+    **Input**:
+
+    ```html
+    <html><body bgcolor="#FFFFFF" text="#000000">
+    <p><br /></p>
+    <div class="moz-forward-container"><br /><br />
+    -------- Forwarded Message --------
+    <table class="moz-email-headers-table">
+      <tbody>
+        <tr><th>Subject:</th><td>Re: Example subject</td></tr>
+        <tr><th>Date:</th><td>Tue, 3 May 2016 14:54:27 +0200 (CEST)</td></tr>
+        <tr><th>From:</th><td>John Doe &lt;johndoe@example.com&gt;</td></tr>
+      </tbody>
+    </table>
+    <br /><br />
+    <div>Dear John,</div>
+    <div><br /></div>
+    <div>This is a test.</div>
+    </div></body></html>
+    ```
+
+    **Expected Output**: Empty (no new content, just forward)
+
+    **Talon's Output**: Includes "-------- Forwarded Message --------" and forwarded content
+
+    **Processing Time**: 4.34ms
+
+    **Issue**: Thunderbird's `moz-forward-container` class not recognized
+
+    ***
+
+    **Summary**: 3 of 4 failures are forwarded messages. Regular replies work with 98%+ accuracy.
+  </Accordion>
+
+  <Accordion title="Success Examples">
+    ### Example 1: Simple Gmail Reply
+
+    **Input**:
+
+    ```text
+    Awesome! I haven't had another problem with it.
+
+    On Aug 22, 2011, at 7:37 PM, defunkt<reply@reply.github.com> wrote:
+
+
+
+
+    > Loader seems to be working well.
+    ```
+
+    **Talon's Output**: `Awesome! I haven't had another problem with it.`
+
+    **Processing Time**: 0.2ms
+
+    **What Worked**: Standard "On \[date] \[name] wrote:" pattern detected, quote marker (>) recognized
+
+    ***
+
+    ### Example 2: Outlook Reply with Separator
+
+    **Input**:
+
+    ```text
+    Outlook with a reply directly above line
+    ________________________________________
+    From: CRM Comments [crm-comment@example.com]
+    Sent: Friday, 23 March 2012 5:08 p.m.
+    To: John S. Greene
+    Subject: [contact:106] John Greene
+
+    A new comment has been added to the Contact named 'John Greene':
+
+    I am replying to a comment.
+    ```
+
+    **Talon's Output**: `Outlook with a reply directly above line`
+
+    **Processing Time**: 0.51ms
+
+    **What Worked**: Outlook separator line (underscores) and "From:"/"Sent:" headers detected as splitter
+
+    ***
+
+    ### Example 3: HTML Outlook Reply
+
+    **Input**:
+
+    ```html
+    <html>
+      <body>
+        <div>Reply</div>
+        <span id="OLK_SRC_BODY_SECTION">
+          <div>
+            <span>From: </span>Bob &lt;<a href="mailto:bob@example.com">bob@example.com</a>&gt;<br />
+            <span>Date: </span>Tue, 01 Nov 2011 18:54:39 -0700<br />
+            <span>To: </span>Rob &lt;<a href="mailto:rob@example.com">rob@example.com</a>&gt;<br />
+            <span>Subject: </span>Test<br />
+          </div>
+          <div>Hi</div>
+        </span>
+      </body>
+    </html>
+    ```
+
+    **Talon's Output**: `Reply`
+
+    **Processing Time**: 4.02ms
+
+    **What Worked**: Outlook's `OLK_SRC_BODY_SECTION` span ID detected and removed structurally
+  </Accordion>
+
+  <Accordion title="Performance vs Simpler Alternatives">
+    **Tradeoff**: Talon is more comprehensive but slower than plain-text-only libraries
+
+    * Talon: 1.92ms average (with HTML support)
+    * email-reply-parser: 0.03ms average (plain text only)
+
+    For production systems, 1.92ms average is negligible. Even at worst case (21.55ms), Talon is faster than most network requests.
+  </Accordion>
+
+  <Accordion title="Forwarded Messages">
+    As shown in test results, forwarded messages (especially HTML) are challenging:
+
+    * Plain text forwards: Generally work well
+    * HTML forwards: May retain forward headers
+    * Workaround: Use plain text extraction or post-process to remove forward markers
+  </Accordion>
+</AccordionGroup>
+
+***
+
+### Error Handling
+
+Always handle potential parsing failures:
+
+```python
+from talon import quotations
+
+def safe_extract(email_body, is_html=False):
+    try:
+        if is_html:
+            return quotations.extract_from_html(email_body)
+        else:
+            return quotations.extract_from_plain(email_body)
+    except Exception as e:
+        # Fallback to original message if extraction fails
+        print(f"Talon extraction failed: {e}")
+        return email_body
+```
+
+### Testing Recommendations
+
+Always test with your specific email formats:
+
+```python
+# Create a test suite with your actual email patterns (Gmail, Outlook, Apple Mail)
+test_emails = [
+    "path/to/gmail_reply.html",
+    "path/to/outlook_reply.txt",
+    "path/to/forward.html"
+]
+
+for email_file in test_emails:
+    with open(email_file) as f:
+        content = f.read()
+        result = quotations.extract_from(content)
+        print(f"{email_file}: {len(result)} chars extracted")
+```
+
+<Tip>
+  Test with real emails from your users' actual email clients. Talon's accuracy is based on diverse real-world samples, but your specific use case may have unique patterns.
+</Tip>
+
+***
+
+## JavaScript Version
+
+For TypeScript/JavaScript projects, use **[TalonJS](https://github.com/quentez/talonjs)** - a JavaScript port of Talon with similar functionality.
+
+### Performance Comparison
+
+| Solution         | Accuracy | Speed  | Best For                    |
+| ---------------- | -------- | ------ | --------------------------- |
+| **Python Talon** | 93.8%    | 1.92ms | Highest accuracy            |
+| **TalonJS**      | 90.6%    | 1.88ms | TypeScript/Node.js projects |
+
+TalonJS provides 90.6% accuracy with slightly faster performance (1.88ms), making it ideal for JavaScript/TypeScript environments without needing Python dependencies.
+
+### Quick Start
+
+<Steps>
+  <Step title="Install TalonJS">
+    ```bash
+    npm install talonjs
+    ```
+  </Step>
+
+  <Step title="Extract Replies">
+    <CodeBlocks>
+      ```typescript title="Plain Text"
+      import * as talon from 'talonjs';
+
+      const email = `Great work on the project!
+
+      On Mon, Apr 11, 2011 at 6:54 PM, Bob wrote:
+      > Can you review the document?
+      > Need feedback by Friday.
+      `;
+
+      const result = talon.quotations.extractFromPlain(email);
+      const cleanReply = result.body.trim();
+      // Output: "Great work on the project!"
+      ```
+
+      ```typescript title="HTML"
+      import * as talon from 'talonjs';
+
+      const htmlEmail = `
+        <div>Thanks for the update!</div>
+        <div class="gmail_quote">
+          On Mon, Alice wrote: <blockquote>Original</blockquote>
+        </div>
+      `;
+
+      const result = talon.quotations.extractFromHtml(htmlEmail);
+      const cleanReply = result.body.trim();
+      // Returns: "<div>Thanks for the update!</div>"
+      // Note: TalonJS returns clean HTML, not plain text
+      ```
+    </CodeBlocks>
+  </Step>
+</Steps>
+
+<Tip>
+  **When to use TalonJS vs Python Talon:**
+
+  * Use **TalonJS** if you're building in TypeScript/JavaScript and 90.6% accuracy is sufficient
+  * Use **Python Talon** if you need the highest accuracy (93.8%) or are in a Python environment
+  * The 3.2% accuracy difference is acceptable for most use cases
+</Tip>
+
+
 # Join the AgentMail Community
 
 > Connect with the AgentMail team and developers, share what you're building, and get support.
 
 <CardGroup>
-  <Card title="Join our Discord Server" href="https://discord.gg/your-invite-code" icon="fa-brands fa-discord">
+  <Card title="Join our Discord Server" href="https://discord.com/invite/hTYatWYWBc" icon="fa-brands fa-discord">
     The best place for real-time conversation, getting help with your code, and
     sharing what you're building with AgentMail.
   </Card>
@@ -5084,6 +5886,8 @@ components:
       type: string
     type_:Count:
       type: integer
+    type_pods:PodId:
+      type: string
     type_inboxes:InboxId:
       type: string
     type_inboxes:DisplayName:
@@ -5093,6 +5897,8 @@ components:
     type_inboxes:Inbox:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
         display_name:
@@ -5106,6 +5912,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -5299,6 +6106,8 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
+    type_pods:PodId:
+      type: string
     type_inboxes:DisplayName:
       type: string
     type_inboxes:ClientId:
@@ -5306,6 +6115,8 @@ components:
     type_inboxes:Inbox:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
         display_name:
@@ -5319,6 +6130,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -5512,11 +6324,15 @@ components:
           $ref: '#/components/schemas/type_inboxes:DisplayName'
         client_id:
           $ref: '#/components/schemas/type_inboxes:ClientId'
+    type_pods:PodId:
+      type: string
     type_inboxes:InboxId:
       type: string
     type_inboxes:Inbox:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
         display_name:
@@ -5530,6 +6346,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -5741,11 +6558,15 @@ components:
           $ref: '#/components/schemas/type_inboxes:DisplayName'
       required:
         - display_name
+    type_pods:PodId:
+      type: string
     type_inboxes:ClientId:
       type: string
     type_inboxes:Inbox:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
         display_name:
@@ -5759,6 +6580,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -8399,6 +9221,10 @@ components:
       type: array
       items:
         $ref: '#/components/schemas/type_attachments:SendAttachment'
+    type_messages:SendMessageHeaders:
+      type: object
+      additionalProperties:
+        type: string
     type_messages:SendMessageRequest:
       type: object
       properties:
@@ -8420,6 +9246,8 @@ components:
           $ref: '#/components/schemas/type_messages:MessageHtml'
         attachments:
           $ref: '#/components/schemas/type_messages:SendMessageAttachments'
+        headers:
+          $ref: '#/components/schemas/type_messages:SendMessageHeaders'
     type_messages:MessageId:
       type: string
     type_threads:ThreadId:
@@ -8692,6 +9520,10 @@ components:
       type: array
       items:
         $ref: '#/components/schemas/type_attachments:SendAttachment'
+    type_messages:SendMessageHeaders:
+      type: object
+      additionalProperties:
+        type: string
     type_messages:ReplyToMessageRequest:
       type: object
       properties:
@@ -8711,6 +9543,8 @@ components:
           $ref: '#/components/schemas/type_messages:MessageHtml'
         attachments:
           $ref: '#/components/schemas/type_messages:SendMessageAttachments'
+        headers:
+          $ref: '#/components/schemas/type_messages:SendMessageHeaders'
     type_threads:ThreadId:
       type: string
     type_messages:SendMessageResponse:
@@ -12924,6 +13758,8 @@ components:
       type: string
     type_:Count:
       type: integer
+    type_pods:PodId:
+      type: string
     type_domains:DomainId:
       type: string
     type_domains:FeedbackEnabled:
@@ -12933,6 +13769,8 @@ components:
     type_domains:DomainItem:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         domain_id:
           $ref: '#/components/schemas/type_domains:DomainId'
         feedback_enabled:
@@ -13140,6 +13978,8 @@ components:
   schemas:
     type_domains:DomainId:
       type: string
+    type_pods:PodId:
+      type: string
     type_domains:VerificationStatus:
       type: string
       enum:
@@ -13182,6 +14022,8 @@ components:
     type_domains:Domain:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         domain_id:
           $ref: '#/components/schemas/type_domains:DomainId'
         status:
@@ -13573,6 +14415,8 @@ components:
       required:
         - domain
         - feedback_enabled
+    type_pods:PodId:
+      type: string
     type_domains:DomainId:
       type: string
     type_domains:VerificationStatus:
@@ -13615,6 +14459,8 @@ components:
     type_domains:Domain:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         domain_id:
           $ref: '#/components/schemas/type_domains:DomainId'
         status:
@@ -14199,7 +15045,7 @@ components:
       type: string
     type_webhooks:Url:
       type: string
-    type_webhooks:EventType:
+    type_events:EventType:
       type: string
       enum:
         - value: message.received
@@ -14208,10 +15054,11 @@ components:
         - value: message.bounced
         - value: message.complained
         - value: message.rejected
-    type_webhooks:EventTypes:
+        - value: domain.verified
+    type_events:EventTypes:
       type: array
       items:
-        $ref: '#/components/schemas/type_webhooks:EventType'
+        $ref: '#/components/schemas/type_events:EventType'
     type_webhooks:InboxIds:
       type: array
       items:
@@ -14226,7 +15073,7 @@ components:
         url:
           $ref: '#/components/schemas/type_webhooks:Url'
         event_types:
-          $ref: '#/components/schemas/type_webhooks:EventTypes'
+          $ref: '#/components/schemas/type_events:EventTypes'
         inbox_ids:
           $ref: '#/components/schemas/type_webhooks:InboxIds'
         secret:
@@ -14440,7 +15287,7 @@ components:
       type: string
     type_webhooks:Url:
       type: string
-    type_webhooks:EventType:
+    type_events:EventType:
       type: string
       enum:
         - value: message.received
@@ -14449,10 +15296,11 @@ components:
         - value: message.bounced
         - value: message.complained
         - value: message.rejected
-    type_webhooks:EventTypes:
+        - value: domain.verified
+    type_events:EventTypes:
       type: array
       items:
-        $ref: '#/components/schemas/type_webhooks:EventType'
+        $ref: '#/components/schemas/type_events:EventType'
     type_webhooks:InboxIds:
       type: array
       items:
@@ -14467,7 +15315,7 @@ components:
         url:
           $ref: '#/components/schemas/type_webhooks:Url'
         event_types:
-          $ref: '#/components/schemas/type_webhooks:EventTypes'
+          $ref: '#/components/schemas/type_events:EventTypes'
         inbox_ids:
           $ref: '#/components/schemas/type_webhooks:InboxIds'
         secret:
@@ -14666,7 +15514,7 @@ components:
   schemas:
     type_webhooks:Url:
       type: string
-    type_webhooks:EventType:
+    type_events:EventType:
       type: string
       enum:
         - value: message.received
@@ -14675,10 +15523,11 @@ components:
         - value: message.bounced
         - value: message.complained
         - value: message.rejected
-    type_webhooks:EventTypes:
+        - value: domain.verified
+    type_events:EventTypes:
       type: array
       items:
-        $ref: '#/components/schemas/type_webhooks:EventType'
+        $ref: '#/components/schemas/type_events:EventType'
     type_webhooks:InboxIds:
       type: array
       items:
@@ -14691,7 +15540,7 @@ components:
         url:
           $ref: '#/components/schemas/type_webhooks:Url'
         event_types:
-          $ref: '#/components/schemas/type_webhooks:EventTypes'
+          $ref: '#/components/schemas/type_events:EventTypes'
         inbox_ids:
           $ref: '#/components/schemas/type_webhooks:InboxIds'
         client_id:
@@ -14709,7 +15558,7 @@ components:
         url:
           $ref: '#/components/schemas/type_webhooks:Url'
         event_types:
-          $ref: '#/components/schemas/type_webhooks:EventTypes'
+          $ref: '#/components/schemas/type_events:EventTypes'
         inbox_ids:
           $ref: '#/components/schemas/type_webhooks:InboxIds'
         secret:
@@ -15710,19 +16559,127 @@ components:
           type: string
         sub_type:
           type: string
-        recipients:
-          type: array
-          items:
-            type: string
+        recipients:
+          type: array
+          items:
+            type: string
+      required:
+        - inbox_id
+        - thread_id
+        - message_id
+        - timestamp
+        - type
+        - sub_type
+        - recipients
+    type_events:MessageComplainedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: message.complained
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        complaint:
+          $ref: '#/components/schemas/type_events:Complaint'
+      required:
+        - type
+        - event_type
+        - event_id
+        - complaint
+
+```
+
+# Message Rejected
+
+POST 
+
+Reference: https://docs.agentmail.to/api-reference/webhooks/events/message-rejected
+
+## OpenAPI 3.1 Webhook Specification
+
+```yaml
+openapi: 3.1.1
+info:
+  title: Message Rejected
+  version: subpackage_webhooks/events.messageRejected
+webhooks:
+  message-rejected:
+    post:
+      operationId: message-rejected
+      summary: Message Rejected
+      tags:
+        - subpackage_webhooks,subpackage_webhooks/events
+      parameters:
+        - name: svix-id
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixId'
+        - name: svix-signature
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixSignature'
+        - name: svix-timestamp
+          in: header
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks/events:SvixTimestamp'
+      responses:
+        '200':
+          description: Webhook received successfully
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/type_events:MessageRejectedEvent'
+components:
+  schemas:
+    type_webhooks/events:SvixId:
+      type: string
+    type_webhooks/events:SvixSignature:
+      type: string
+    type_webhooks/events:SvixTimestamp:
+      type: string
+      format: date-time
+    type_events:EventId:
+      type: string
+    type_inboxes:InboxId:
+      type: string
+    type_threads:ThreadId:
+      type: string
+    type_messages:MessageId:
+      type: string
+    type_events:Timestamp:
+      type: string
+      format: date-time
+    type_events:Reject:
+      type: object
+      properties:
+        inbox_id:
+          $ref: '#/components/schemas/type_inboxes:InboxId'
+        thread_id:
+          $ref: '#/components/schemas/type_threads:ThreadId'
+        message_id:
+          $ref: '#/components/schemas/type_messages:MessageId'
+        timestamp:
+          $ref: '#/components/schemas/type_events:Timestamp'
+        reason:
+          type: string
       required:
         - inbox_id
         - thread_id
         - message_id
         - timestamp
-        - type
-        - sub_type
-        - recipients
-    type_events:MessageComplainedEvent:
+        - reason
+    type_events:MessageRejectedEvent:
       type: object
       properties:
         type:
@@ -15734,37 +16691,37 @@ components:
           type: string
           enum:
             - type: stringLiteral
-              value: message.complained
+              value: message.rejected
         event_id:
           $ref: '#/components/schemas/type_events:EventId'
-        complaint:
-          $ref: '#/components/schemas/type_events:Complaint'
+        reject:
+          $ref: '#/components/schemas/type_events:Reject'
       required:
         - type
         - event_type
         - event_id
-        - complaint
+        - reject
 
 ```
 
-# Message Rejected
+# Domain Verified
 
 POST 
 
-Reference: https://docs.agentmail.to/api-reference/webhooks/events/message-rejected
+Reference: https://docs.agentmail.to/api-reference/webhooks/events/domain-verified
 
 ## OpenAPI 3.1 Webhook Specification
 
 ```yaml
 openapi: 3.1.1
 info:
-  title: Message Rejected
-  version: subpackage_webhooks/events.messageRejected
+  title: Domain Verified
+  version: subpackage_webhooks/events.domainVerified
 webhooks:
-  message-rejected:
+  domain-verified:
     post:
-      operationId: message-rejected
-      summary: Message Rejected
+      operationId: domain-verified
+      summary: Domain Verified
       tags:
         - subpackage_webhooks,subpackage_webhooks/events
       parameters:
@@ -15790,7 +16747,7 @@ webhooks:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/type_events:MessageRejectedEvent'
+              $ref: '#/components/schemas/type_events:DomainVerifiedEvent'
 components:
   schemas:
     type_webhooks/events:SvixId:
@@ -15802,35 +16759,80 @@ components:
       format: date-time
     type_events:EventId:
       type: string
-    type_inboxes:InboxId:
+    type_pods:PodId:
       type: string
-    type_threads:ThreadId:
+    type_domains:DomainId:
       type: string
-    type_messages:MessageId:
+    type_domains:VerificationStatus:
       type: string
-    type_events:Timestamp:
+      enum:
+        - value: PENDING
+        - value: VERIFYING
+        - value: READY
+    type_domains:FeedbackEnabled:
+      type: boolean
+    type_domains:RecordType:
       type: string
-      format: date-time
-    type_events:Reject:
+      enum:
+        - value: TXT
+        - value: CNAME
+        - value: MX
+    type_domains:RecordStatus:
+      type: string
+      enum:
+        - value: MISSING
+        - value: VERIFIED
+    type_domains:VerificationRecord:
       type: object
       properties:
-        inbox_id:
-          $ref: '#/components/schemas/type_inboxes:InboxId'
-        thread_id:
-          $ref: '#/components/schemas/type_threads:ThreadId'
-        message_id:
-          $ref: '#/components/schemas/type_messages:MessageId'
-        timestamp:
-          $ref: '#/components/schemas/type_events:Timestamp'
-        reason:
+        type:
+          $ref: '#/components/schemas/type_domains:RecordType'
+        name:
+          type: string
+        value:
           type: string
+        status:
+          $ref: '#/components/schemas/type_domains:RecordStatus'
+        priority:
+          type: integer
       required:
-        - inbox_id
-        - thread_id
-        - message_id
-        - timestamp
-        - reason
-    type_events:MessageRejectedEvent:
+        - type
+        - name
+        - value
+        - status
+    type_domains:ClientId:
+      type: string
+    type_domains:Domain:
+      type: object
+      properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
+        domain_id:
+          $ref: '#/components/schemas/type_domains:DomainId'
+        status:
+          $ref: '#/components/schemas/type_domains:VerificationStatus'
+        feedback_enabled:
+          $ref: '#/components/schemas/type_domains:FeedbackEnabled'
+        records:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_domains:VerificationRecord'
+        client_id:
+          $ref: '#/components/schemas/type_domains:ClientId'
+        updated_at:
+          type: string
+          format: date-time
+        created_at:
+          type: string
+          format: date-time
+      required:
+        - domain_id
+        - status
+        - feedback_enabled
+        - records
+        - updated_at
+        - created_at
+    type_events:DomainVerifiedEvent:
       type: object
       properties:
         type:
@@ -15842,16 +16844,16 @@ components:
           type: string
           enum:
             - type: stringLiteral
-              value: message.rejected
+              value: domain.verified
         event_id:
           $ref: '#/components/schemas/type_events:EventId'
-        reject:
-          $ref: '#/components/schemas/type_events:Reject'
+        domain:
+          $ref: '#/components/schemas/type_domains:Domain'
       required:
         - type
         - event_type
         - event_id
-        - reject
+        - domain
 
 ```
 
@@ -15896,6 +16898,8 @@ channels:
               #/components/messages/subpackage_websockets.websockets-server-5-message_complained
           - $ref: >-
               #/components/messages/subpackage_websockets.websockets-server-6-message_rejected
+          - $ref: >-
+              #/components/messages/subpackage_websockets.websockets-server-7-domain_verified
     subscribe:
       operationId: websockets-subscribe
       summary: Client message
@@ -15941,7 +16945,25 @@ components:
       name: message_rejected
       payload:
         $ref: '#/components/schemas/type_events:MessageRejectedEvent'
+    subpackage_websockets.websockets-server-7-domain_verified:
+      name: domain_verified
+      payload:
+        $ref: '#/components/schemas/type_events:DomainVerifiedEvent'
   schemas:
+    type_events:EventType:
+      type: string
+      enum:
+        - value: message.received
+        - value: message.sent
+        - value: message.delivered
+        - value: message.bounced
+        - value: message.complained
+        - value: message.rejected
+        - value: domain.verified
+    type_events:EventTypes:
+      type: array
+      items:
+        $ref: '#/components/schemas/type_events:EventType'
     type_websockets:Subscribed:
       type: object
       properties:
@@ -15950,13 +16972,18 @@ components:
           enum:
             - type: stringLiteral
               value: subscribed
+        event_types:
+          $ref: '#/components/schemas/type_events:EventTypes'
         inbox_ids:
           type: array
           items:
             type: string
+        pod_ids:
+          type: array
+          items:
+            type: string
       required:
         - type
-        - inbox_ids
     type_events:EventId:
       type: string
     type_inboxes:InboxId:
@@ -16355,6 +17382,101 @@ components:
         - event_type
         - event_id
         - reject
+    type_pods:PodId:
+      type: string
+    type_domains:DomainId:
+      type: string
+    type_domains:VerificationStatus:
+      type: string
+      enum:
+        - value: PENDING
+        - value: VERIFYING
+        - value: READY
+    type_domains:FeedbackEnabled:
+      type: boolean
+    type_domains:RecordType:
+      type: string
+      enum:
+        - value: TXT
+        - value: CNAME
+        - value: MX
+    type_domains:RecordStatus:
+      type: string
+      enum:
+        - value: MISSING
+        - value: VERIFIED
+    type_domains:VerificationRecord:
+      type: object
+      properties:
+        type:
+          $ref: '#/components/schemas/type_domains:RecordType'
+        name:
+          type: string
+        value:
+          type: string
+        status:
+          $ref: '#/components/schemas/type_domains:RecordStatus'
+        priority:
+          type: integer
+      required:
+        - type
+        - name
+        - value
+        - status
+    type_domains:ClientId:
+      type: string
+    type_domains:Domain:
+      type: object
+      properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
+        domain_id:
+          $ref: '#/components/schemas/type_domains:DomainId'
+        status:
+          $ref: '#/components/schemas/type_domains:VerificationStatus'
+        feedback_enabled:
+          $ref: '#/components/schemas/type_domains:FeedbackEnabled'
+        records:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_domains:VerificationRecord'
+        client_id:
+          $ref: '#/components/schemas/type_domains:ClientId'
+        updated_at:
+          type: string
+          format: date-time
+        created_at:
+          type: string
+          format: date-time
+      required:
+        - domain_id
+        - status
+        - feedback_enabled
+        - records
+        - updated_at
+        - created_at
+    type_events:DomainVerifiedEvent:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: event
+        event_type:
+          type: string
+          enum:
+            - type: stringLiteral
+              value: domain.verified
+        event_id:
+          $ref: '#/components/schemas/type_events:EventId'
+        domain:
+          $ref: '#/components/schemas/type_domains:Domain'
+      required:
+        - type
+        - event_type
+        - event_id
+        - domain
     type_websockets:Subscribe:
       type: object
       properties:
@@ -16363,13 +17485,18 @@ components:
           enum:
             - type: stringLiteral
               value: subscribe
+        event_types:
+          $ref: '#/components/schemas/type_events:EventTypes'
         inbox_ids:
           type: array
           items:
             type: string
+        pod_ids:
+          type: array
+          items:
+            type: string
       required:
         - type
-        - inbox_ids
 
 ```
 
@@ -18173,6 +19300,8 @@ components:
     type_inboxes:Inbox:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
         display_name:
@@ -18186,6 +19315,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -18396,6 +19526,8 @@ components:
     type_inboxes:Inbox:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
         display_name:
@@ -18409,6 +19541,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -18616,6 +19749,8 @@ components:
     type_inboxes:Inbox:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         inbox_id:
           $ref: '#/components/schemas/type_inboxes:InboxId'
         display_name:
@@ -18629,6 +19764,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -20698,6 +21834,8 @@ components:
     type_domains:DomainItem:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         domain_id:
           $ref: '#/components/schemas/type_domains:DomainId'
         feedback_enabled:
@@ -20970,6 +22108,8 @@ components:
     type_domains:Domain:
       type: object
       properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
         domain_id:
           $ref: '#/components/schemas/type_domains:DomainId'
         status:
@@ -21334,25 +22474,3 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
-# August 13, 2025
-
-## Summary
-
-We're excited to introduce **Metrics Endpoints** - two new powerful endpoints that give you deep insights into your email deliverability and agent performance. Track critical events like bounces, deliveries, rejections, and complaints with detailed timestamps.
-
-### What's new?
-
-New endpoints:
-
-* `GET /metrics` - Get comprehensive metrics across all your inboxes
-* `GET /inboxes/{inbox_id}/metrics` - Get metrics for a specific inbox
-
-Build smarter agents that monitor their own bounce rates, optimize send timing, and automatically adjust behavior based on deliverability metrics. This unlocks exciting possibilities for self-optimizing agents that can pause campaigns when performance drops or implement intelligent retry strategies.
-
-<Note>
-  Ready to build smarter agents? Check out our [metrics
-  documentation](https://docs.agentmail.to/api-reference/metrics) to get
-  started.
-</Note>
-
-