agentmail 0.1.6 → 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:f8c5320f-b15c-44e7-a569-670c5f1d2a88) 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:ac426e5d-2c1a-40b1-bf52-5c97883187df" 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:3e435f8a-5583-4ddd-83a3-c3f87c5f3aac" 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:fdcf475d-78f0-49a1-aa38-5bd877368f56" 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:01476e8c-76ae-4414-b008-0547631c47f1" 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:86767929-19ef-4ded-b528-ed42ede218fe" 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:1886368e-04ae-4bfe-a117-83246de25118" 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:b966738e-c0e6-425d-86d1-0ce95b9a326d" 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:57da42f8-9541-4e8a-9b20-7c81ca585355" 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:2824bdf3-c4c7-4dfe-b67a-1373865ecf22" 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:62bea4af-5b5e-4f88-86ce-b569f26f8a74" alt="AWS Route 53 Record Configuration" />
+              <img src="file:e57473d0-08bd-4ddc-ba64-0ff6c2e49ccc" alt="AWS Route 53 Record Configuration" />
             </Frame>
 
             * **TXT (DMARC/SPF):**
@@ -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:845efbdc-7a3b-44be-b7b6-d85c15baabfd" 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:6bf31cc4-f08c-4b45-9abd-b93966def3ab" 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:190c3920-7025-4399-8718-b2b9a4895382" 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:933ee151-1684-4e56-b2a9-4dd7e81f9f5d" 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:256ac0e7-42b8-4fdd-a3f1-6136fbec2725" 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">
@@ -4724,7 +4974,7 @@ Done
 
 Go to your AgentMail inbox and filter by labels to organize your emails:
 
-<img src="file:0cf3d744-bb78-46de-acc7-e3de13a39cf9" alt="Test image" />
+<img src="file:19536629-9971-42f0-b8c1-ffa1f9849fd5" alt="Test image" />
 
 **Filter by sentiment:**
 
@@ -5636,6 +5886,8 @@ components:
       type: string
     type_:Count:
       type: integer
+    type_pods:PodId:
+      type: string
     type_inboxes:InboxId:
       type: string
     type_inboxes:DisplayName:
@@ -5645,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:
@@ -5658,6 +5912,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -5851,6 +6106,8 @@ components:
   schemas:
     type_inboxes:InboxId:
       type: string
+    type_pods:PodId:
+      type: string
     type_inboxes:DisplayName:
       type: string
     type_inboxes:ClientId:
@@ -5858,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:
@@ -5871,6 +6130,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -6064,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:
@@ -6082,6 +6346,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -6293,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:
@@ -6311,6 +6580,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -8951,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:
@@ -8972,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:
@@ -9244,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:
@@ -9263,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:
@@ -13476,6 +13758,8 @@ components:
       type: string
     type_:Count:
       type: integer
+    type_pods:PodId:
+      type: string
     type_domains:DomainId:
       type: string
     type_domains:FeedbackEnabled:
@@ -13485,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:
@@ -13692,6 +13978,8 @@ components:
   schemas:
     type_domains:DomainId:
       type: string
+    type_pods:PodId:
+      type: string
     type_domains:VerificationStatus:
       type: string
       enum:
@@ -13734,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:
@@ -14125,6 +14415,8 @@ components:
       required:
         - domain
         - feedback_enabled
+    type_pods:PodId:
+      type: string
     type_domains:DomainId:
       type: string
     type_domains:VerificationStatus:
@@ -14167,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:
@@ -14751,7 +15045,7 @@ components:
       type: string
     type_webhooks:Url:
       type: string
-    type_webhooks:EventType:
+    type_events:EventType:
       type: string
       enum:
         - value: message.received
@@ -14760,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:
@@ -14778,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:
@@ -14992,7 +15287,7 @@ components:
       type: string
     type_webhooks:Url:
       type: string
-    type_webhooks:EventType:
+    type_events:EventType:
       type: string
       enum:
         - value: message.received
@@ -15001,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:
@@ -15019,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:
@@ -15218,7 +15514,7 @@ components:
   schemas:
     type_webhooks:Url:
       type: string
-    type_webhooks:EventType:
+    type_events:EventType:
       type: string
       enum:
         - value: message.received
@@ -15227,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:
@@ -15243,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:
@@ -15261,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:
@@ -16407,6 +16704,159 @@ components:
 
 ```
 
+# Domain Verified
+
+POST 
+
+Reference: https://docs.agentmail.to/api-reference/webhooks/events/domain-verified
+
+## OpenAPI 3.1 Webhook Specification
+
+```yaml
+openapi: 3.1.1
+info:
+  title: Domain Verified
+  version: subpackage_webhooks/events.domainVerified
+webhooks:
+  domain-verified:
+    post:
+      operationId: domain-verified
+      summary: Domain Verified
+      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:DomainVerifiedEvent'
+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_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
+
+```
+
 # Connect
 
 GET /v0
@@ -16448,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
@@ -16493,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:
@@ -16502,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:
@@ -16907,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:
@@ -16915,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
 
 ```
 
@@ -18725,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:
@@ -18738,6 +19315,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -18948,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:
@@ -18961,6 +19541,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -19168,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:
@@ -19181,6 +19764,7 @@ components:
           type: string
           format: date-time
       required:
+        - pod_id
         - inbox_id
         - updated_at
         - created_at
@@ -21250,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:
@@ -21522,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:
@@ -21886,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>
-
-