---
title: "Add time limited alias"
method: POST
path: "/v1beta/mailcow/time-limted/alias"
tags: ["MailcowAlias"]
---

# Add time limited alias

`POST /v1beta/mailcow/time-limted/alias`

## Request body

- AliasAddTimeLimitedAliasRequest
  - `domain` AliasDomain
    - `extension` string
    - `name` string
  - `mailbox` string

## Response `200`

A successful response.

- AliasAddTimeLimitedAliasResponse
  - `code` integer
  - `data` AliasAddTimeLimitedAliasResponseData
    - `results` AliasTimeLimitedAliasData[]
      - `alias` string
      - `created` string
      - `mailbox` string
      - `validity` integer
  - `desc` string
  - `warnings` ErrorWarning[]
    - `code` integer
    - `data` string
    - `desc` string

## Other responses

- `default` — (empty)

## Changes

- **2026-08-27** `a57b11984574` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openprovider/apis/rest-api/changes/v1beta/mailcow/time-limted/alias/post.md)

---

[API](https://skmtc.dev/openprovider/apis/rest-api.md) · [All operations](https://skmtc.dev/openprovider/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openprovider/rest-api/revisions/a57b11984574/schema)
