# AgentMail Update Inbox

> AgentMail Update Inbox is a free API for AI agents from AgentMail at mpp.api.agentmail.to, Free, status unknown (last checked 2026-10-09).

Updates the display name of a specific email inbox by its inbox ID

## Facts

- Endpoint: PATCH https://mpp.api.agentmail.to/v0/inboxes/:inbox_id?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-09
- 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-inbox-id-3071dfb9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GlDnHHh6EQLmlDKUh8RCd

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-inbox-id-3071dfb9 -d '<json body>'
```

Example prompt: Update the display name on my AgentMail inbox (inbox ID 'inbox_abc123') to 'Support Bot <support@myagent.agentmail.to>'.

## When to prefer this

Use this endpoint when you need to change the human-readable display name of an existing AgentMail inbox, such as rebranding an AI agent's email identity or updating the sender name shown in email clients. Prefer this over recreating the inbox when only the display name needs to change.

## Known failure modes

- inbox_id not found returns 404
- missing or invalid Authorization header returns 401
- missing required display_name field returns 422 validation error
- malformed inbox_id path parameter returns 400

## How this service works

Update Inbox

## Output

Returns the full updated Inbox object including inbox_id, pod_id, client_id, the new display_name, and timestamps for created_at and updated_at.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "UpdateInboxRequest",
 "required": [
  "display_name"
 ],
 "properties": {
  "display_name": {
   "type": "string",
   "title": "DisplayName",
   "description": "Display name: `Display Name <username@domain.com>`."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Inbox",
 "required": [
  "pod_id",
  "inbox_id",
  "updated_at",
  "created_at"
 ],
 "properties": {
  "pod_id": {
   "type": "string",
   "title": "PodId",
   "description": "ID of pod."
  },
  "inbox_id": {
   "type": "string",
   "title": "InboxId",
   "description": "The ID of the inbox."
  },
  "client_id": {
   "type": "string",
   "title": "ClientId",
   "description": "Client ID of inbox."
  },
  "created_at": {
   "type": "string",
   "format": "date-time",
   "description": "Time at which inbox was created."
  },
  "updated_at": {
   "type": "string",
   "format": "date-time",
   "description": "Time at which inbox was last updated."
  },
  "display_name": {
   "type": "string",
   "title": "DisplayName",
   "description": "Display name: `Display Name <username@domain.com>`."
  }
 }
}
```

## More

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