---
title: "Changes to Create agent email inbox"
method: POST
path: "/v1/agent-mail/create"
---

# Changes to Create agent email inbox

`POST /v1/agent-mail/create`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 21 revisions.

- **2026-10-10** `358e18da87ac`: 7 breaking, 2 warning, 13 info
- **2026-04-08** `a46514573a08`: 1 info

## Changes

- **2026-10-10** `358e18da87ac`: 7 breaking, 2 warning, 13 info
  - added the new required `header` request parameter `X-Agent-DID`
  - added the new required `header` request parameter `X-Mail-Nonce`
  - added the new required `header` request parameter `X-Mail-Pow`
  - added the new required `header` request parameter `X-Mail-Timestamp`
  - the `address` request property's minLength was increased from `0` to `3`
  - added the pattern `^[a-z][a-z0-9._-]*[a-z0-9]$` to the request property `address`
  - removed the success response with the status `200`
  - the `address` request property's maxLength was set to `30`
  - the `name` request property's maxLength was set to `128`
  - api operation id `agentMailCreate` was added
  - the endpoint scheme security `AgentMailCreateSignature` was added to the API
  - added the new optional request property `content_policy`
  - added the new optional request property `owner_key`
  - added the new optional request property `recipient_policy`
  - the request property `name` became optional
  - added the media type `application/json` for the response with the status `409`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `413`
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the success response with the status `201`
- **2026-04-08** `a46514573a08`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/voidly/apis/voidly-api/docs/v1/agent-mail/create/post.md) - [API](https://skmtc.dev/voidly/apis/voidly-api.md) - [Page](https://skmtc.dev/voidly/apis/voidly-api/changes/v1/agent-mail/create/post)