# StableEmail Update Inbox Settings

> StableEmail Update Inbox Settings is a free API for AI agents from StableEmail at stableemail.dev, callable via MPP, Free, status unknown (last checked 2026-10-09).

Update forwarding address and message retention settings for a StableEmail inbox

## Facts

- Endpoint: POST https://stableemail.dev/api/inbox/update?utm_source=zero.xyz
- Price: Free
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Provider: StableEmail
- Docs: https://stableemail.dev
- Website: https://stableemail.dev
- Tags: email, send, inbox, forwarding, subdomain, social
- Canonical page: https://www.zero.xyz/c/stableemail-update-34575c5e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GAR-8Z8vxGFSvwp8AgbiO

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 stableemail-update-34575c5e -d '<json body>'
```

Example prompt: Update my StableEmail inbox 'myproject' to forward incoming messages to newaddress@gmail.com and make sure message retention is turned on.

## When to prefer this

Use this endpoint when you need to change the forwarding destination or message retention setting of an existing StableEmail inbox at no cost. Prefer this over recreating the inbox when only settings need to change.

## Known failure modes

- Invalid username format (must match pattern ^[a-z0-9][a-z0-9-]{1,28}[a-z0-9]$ with no double hyphens)
- Invalid forwardTo email address format
- Inbox does not exist for the given username
- Network or server error returning 5xx

## How this service works

Update inbox settings (free)

## Output

Confirmation that the inbox settings have been updated, reflecting the new forwarding address and/or message retention preference for the specified username.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "username"
 ],
 "properties": {
  "username": {
   "type": "string",
   "allOf": [
    {
     "pattern": "^[a-z0-9][a-z0-9-]{1,28}[a-z0-9]$"
    },
    {
     "pattern": "^(?!.*--)"
    }
   ]
  },
  "forwardTo": {
   "anyOf": [
    {
     "type": "string",
     "format": "email",
     "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    {
     "type": "null"
    }
   ]
  },
  "retainMessages": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stableemail-update-34575c5e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stableemail.dev](https://www.zero.xyz/host/stableemail.dev/llms.txt)