# Mermail Agent API

**Canonical:** https://apis.io/apis/mermail-app/mermail-app-agent-api/  
**Provider:** Mermail — https://apis.io/providers/mermail-app/  
**Base URL:** https://console.mermail.app  
**Documentation:** https://docs.mermail.app/api-reference/overview

Mermail Agent API is one of 2 APIs that [Mermail](https://apis.io/providers/mermail-app/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification.

The Agent API from Mermail — 13 operation(s) for agent.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/agent/v1/mailboxes` | Create a hosted agent inbox |
| GET | `/api/agent/v1/mailboxes` | List wallet-bound inboxes |
| GET | `/api/agent/v1/mailboxes/{mailboxId}` | Get a wallet-bound inbox |
| GET | `/api/agent/v1/mailboxes/{mailboxId}/emails` | List inbox messages |
| POST | `/api/agent/v1/mailboxes/{mailboxId}/emails` | Send an email |
| GET | `/api/agent/v1/mailboxes/{mailboxId}/emails/{emailId}` | Get a message |
| GET | `/api/agent/v1/mailboxes/{mailboxId}/emails/{emailId}/context` | Get safe message context |
| GET | `/api/agent/v1/mailboxes/{mailboxId}/search` | Search inbox messages |
| GET | `/api/agent/v1/mailboxes/{mailboxId}/threads/{threadId}` | Get a message thread |
| GET | `/api/agent/v1/mailboxes/{mailboxId}/attachments/{attachmentId}` | Download an attachment |
| GET | `/api/agent/v1/mailboxes/{mailboxId}/folders` | List inbox folders |
| GET | `/api/agent/v1/mailboxes/{mailboxId}/custom-labels` | List custom labels |
| POST | `/api/agent/v1/mailboxes/{mailboxId}/emails/{emailId}/reply` | Reply to an email |
| POST | `/api/agent/v1/mailboxes/{mailboxId}/emails/{emailId}/forward` | Forward an email |
| POST | `/api/agent/v1/mailboxes/{mailboxId}/drafts` | Save a draft |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/mermail-app/openapi/mermail-app-agent-api-openapi.yml
- **APIsJSON** — https://artifacts.apis.io/mermail-app/apis.yml

## Other Mermail APIs (1)

- [Mermail Mermail Agent Marketplace API](https://apis.io/apis/mermail-app/mermail-app-mermail-agent-marketplace-api/)

## Tags

Agents

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/mermail-app` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/mermail-app/mermail-app-agent-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/mermail-app/.
