# AgentMail Get Message

> AgentMail Get Message is a free API for AI agents from AgentMail at mpp.api.agentmail.to, Free, status unknown (last checked 2026-10-11, last successful call 2026-05-15).

Retrieves a specific email message by inbox ID and message ID, returning full message content including headers, body, recipients, and metadata.

## Facts

- Endpoint: GET https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/messages/:message_id?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-11
- Last successful call: 2026-05-15
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- 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-message-id-5b61a3d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5kPg2AfRCs3U3dKEeHsgU

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-message-id-5b61a3d3
```

Example prompt: Pull up the full content of message msg_abc123 from inbox inbox_xyz456 in AgentMail — I need the subject, body, sender, and any CC recipients.

## When to prefer this

Use this endpoint when you need the full content and metadata of a single known email message within an AgentMail inbox. Prefer this over listing endpoints when you already have the message_id and need complete body text, HTML, headers, or recipient details for a specific message.

## Known failure modes

- 404 Not Found if inbox_id or message_id does not exist
- 401 Unauthorized if Bearer token is missing or invalid
- 400 Bad Request if inbox_id or message_id parameters are malformed
- Message exists but inbox does not belong to the authenticated user

## How this service works

Get Message

## Output

Returns a Message object containing: inbox_id, thread_id, message_id, from, to, cc, bcc, reply_to, subject, text body, HTML body, labels, headers, preview, size in bytes, timestamp, created_at, and updated_at fields.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "inbox_id",
  "message_id"
 ],
 "properties": {
  "inbox_id": {
   "type": "string",
   "title": "InboxId",
   "description": "The ID of the inbox."
  },
  "message_id": {
   "type": "string",
   "title": "MessageId",
   "description": "ID of message."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Message",
 "required": [
  "inbox_id",
  "thread_id",
  "message_id",
  "labels",
  "timestamp",
  "from",
  "to",
  "size",
  "updated_at",
  "created_at"
 ],
 "properties": {
  "cc": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "MessageCc",
   "description": "Addresses of CC recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."
  },
  "to": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "MessageTo",
   "description": "Addresses of recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."
  },
  "bcc": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "MessageBcc",
   "description": "Addresses of BCC recipients. In format `username@domain.com` or `Display Name <username@domain.com>`."
  },
  "from": {
   "type": "string",
   "title": "MessageFrom",
   "description": "Address of sender. In format `username@domain.com` or `Display Name <username@domain.com>`."
  },
  "html": {
   "type": "string",
   "title": "MessageHtml",
   "description": "HTML body of message."
  },
  "size": {
   "type": "integer",
   "title": "MessageSize",
   "description": "Size of message in bytes."
  },
  "text": {
   "type": "string",
   "title": "MessageText",
   "description": "Plain text body of message."
  },
  "labels": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "MessageLabels",
   "description": "Labels of message."
  },
  "headers": {
   "type": "object",
   "title": "MessageHeaders",
   "description": "Headers in message.",
   "additionalProperties": {
    "type": "string"
   }
  },
  "preview": {
   "type": "string",
   "title": "MessagePreview",
   "description": "Text preview of message."
  },
  "subject": {
   "type": "string",
   "title": "MessageSubject",
   "description": "Subject of message."
  },
  "inbox_id": {
   "type": "string",
   "title": "InboxId",
   "description": "The ID of the inbox."
  },
  "reply_to": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Reply-to addresses. In format `username@domain.com` or `Display Name <username@domain.com>`."
  },
  "thread_id": {
   "type": "string",
   "title": "ThreadId",
   "description": "ID of thread."
  },
  "timestamp": {
   "type": "string",
   "title": "MessageTimestamp",
   "format": "date-time",
   "description": "Time at which message was sent or drafted."
  },
  "creat
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-message-id-5b61a3d3/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)