v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01960201.2 KB

Aliases

Create time limited alias

You may create a time limited alias using this action. It takes a JSON object containing a domain and mailbox informations. Mailcow will generate a random alias.

post/api/v1/add/time_limited_alias

Request body

usernamestring

the mailbox an alias should be created for

domainstring

the domain

descriptionstring

a description for the alias, defaults to an empty string

validityinteger

how many hours the alias stays valid, 1 to 87600, defaults to 8760 (one year)

permanentboolean

keep the alias after it expired, defaults to false

Example request

{
  "username": "info@domain.tld",
  "domain": "domain.tld",
  "description": "my time limited alias",
  "validity": 8760,
  "permanent": false
}

Response

type'success' | 'danger' | 'error'