---
title: "mail.addresses.write · OpenVibe.Services"
canonical: "https://openvibe.services/docs/capabilities/mail.addresses.write"
updated: null
---

# mail.addresses.write · OpenVibe.Services

HTML: [mail.addresses.write · OpenVibe.Services](https://openvibe.services/docs/capabilities/mail.addresses.write)

# `mail.addresses.write`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

Not grantable to apps (active, first-party).

Make and retire the addresses OpenVibe.Mail hands out for a person: a mask (a per-site address that delivers into their OpenVibe mailbox and nowhere else) and an agent inbox (<agent>.<user>@openvibe.email). Turning a mask off makes its address bounce. The caller must act for the person (on\_behalf\_of); it never sends mail.

- Owner: mail (token audience `openvibe.mail`)
- Version: 1.0
- Status: active
- Visibility: first-party
- Resource constraints: owner
- Quota class: mail-addresses-write
- Permissions: mail:addresses:write
- Events: mail.mask.created
- Implemented by: - `POST /api/v1/masks`
- `POST /api/v1/masks/:id/disable`
- `DELETE /api/v1/masks/:id`
- `POST /api/v1/agent-inboxes`

[These routes in the API explorer](/docs/api/mail#cap-mail.addresses.write)