# AgentMail List Threads

> AgentMail List Threads is a free API for AI agents from AgentMail at mpp.api.agentmail.to, callable via MPP, Free, status unknown (last checked 2026-10-11).

Lists email threads in an AgentMail inbox with filtering by date, labels, and spam/trash status

## Facts

- Endpoint: GET https://mpp.api.agentmail.to/v0/threads?utm_source=zero.xyz
- Price: Free
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: AgentMail
- Docs: https://docs.agentmail.to
- Website: https://agentmail.to
- Tags: email, inboxes, domains, drafts, threads, webhooks, messaging, ai, social
- Canonical page: https://www.zero.xyz/c/agentmail-threads-a38c814f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ONxE4ahb5mgaK0RoaCaTG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentmail-threads-a38c814f
```

Example prompt: Show me the 20 most recent email threads in my AgentMail inbox from the last 7 days, sorted newest first, and include any spam — skip trash though.

## When to prefer this

Use this endpoint when an AI agent needs to browse, monitor, or search through email threads in an AgentMail inbox. Ideal for polling for new messages, filtering conversations by label or time window, or building an email triage workflow. Prefer over individual message endpoints when you need conversation-level summaries rather than full message content.

## Known failure modes

- 401 Unauthorized — missing or invalid Bearer token in Authorization header
- 400 Bad Request — malformed date-time format for before/after parameters
- 400 Bad Request — invalid page_token value
- Empty threads array with count=0 — no threads match the filter criteria
- Truncated response — limit exceeded or pagination required for large inboxes

## How this service works

List Threads

## Output

Returns a paginated list of email thread summaries including thread ID, subject, senders, recipients, labels, message count, size, preview text of the last message, attachment metadata, and timestamps. Also includes total count and limit for pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "after": {
   "type": "string",
   "title": "After",
   "format": "date-time",
   "description": "Timestamp after which to filter by."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "before": {
   "type": "string",
   "title": "Before",
   "format": "date-time",
   "description": "Timestamp before which to filter by."
  },
  "labels": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Labels",
   "description": "Labels to filter by."
  },
  "ascending": {
   "type": "boolean",
   "title": "Ascending",
   "description": "Sort in ascending temporal order."
  },
  "page_token": {
   "type": "string",
   "title": "PageToken",
   "description": "Page token for pagination."
  },
  "include_spam": {
   "type": "boolean",
   "title": "IncludeSpam",
   "description": "Include spam in results."
  },
  "include_trash": {
   "type": "boolean",
   "title": "IncludeTrash",
   "description": "Include trash in results."
  },
  "include_blocked": {
   "type": "boolean",
   "title": "IncludeBlocked",
   "description": "Include blocked in results."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ListThreadsResponse",
 "required": [
  "count",
  "threads"
 ],
 "properties": {
  "count": {
   "type": "integer",
   "title": "Count",
   "description": "Number of items returned."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "threads": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "ThreadItem",
    "required": [
     "inbox_id",
     "thread_id",
     "labels",
     "timestamp",
     "senders",
     "recipients",
     "last_message_id",
     "message_count",
     "size",
     "updated_at",
     "created_at"
    ],
    "properties": {
     "size": {
      "type": "integer",
      "title": "ThreadSize",
      "description": "Size of thread in bytes."
     },
     "labels": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "ThreadLabels",
      "description": "Labels of thread."
     },
     "preview": {
      "type": "string",
      "title": "ThreadPreview",
      "description": "Text preview of last message in thread."
     },
     "senders": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "ThreadSenders",
      "description": "Senders in thread. In format `username@domain.com` or `Display Name <username@domain.com>`."
     },
     "subject": {
      "type": "string",
      "title": "ThreadSubject",
      "description": "Subject of thread."
     },
     "inbox_id": {
      "type": "string",
      "title": "InboxId",
      "description": "The ID of the inbox."
     },
     "thread_id": {
      "type": "string",
      "title": "ThreadId",
      "description": "ID of thread."
     },
     "timestamp": {
      "type": "string",
      "title": "ThreadTimestamp",
      "format": "date-time",
      "description": "Timestamp of last sent or received message."
     },
     "created_at": {
      "type": "string",
      "title": "ThreadCreatedAt",
      "format": "date-time",
      "description": "Time at which thread was created."
     },
     "recipients": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "ThreadRecipients",
      "description": "Recipients in thread. In format `username@domain.com` or `Display Name <username@domain.com>`."
     },
     "updated_at": {
      "type": "string",
      "title": "ThreadUpdatedAt",
      "format": "date-time",
      "description": "Time at which thread was last updat
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-threads-a38c814f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.api.agentmail.to](https://www.zero.xyz/host/mpp.api.agentmail.to/llms.txt)