OptionaldescriptionOptional free-text description.
The domain to generate the alias under. Must be the mailbox's own domain or one of its alias domains.
OptionalpermanentIf true, the alias never expires and validity is ignored.
OptionalusernameThe mailbox the alias should forward to. Defaults to the API-authenticated mailbox when omitted.
OptionalvalidityHow many hours the alias stays valid, from 1 to 87600 (10 years).
Defaults to 8760 (1 year). Ignored when permanent is true.
Request payload to create a time-limited (burner) alias. Mailcow always generates the address itself; there is no way to request a specific one.