---
title: "Create a new email alias."
method: POST
path: "/api/v1/aliases"
tags: ["Endpoints"]
---

# Create a new email alias.

`POST /api/v1/aliases`

## Request

- Base URL: `https://hidemail.app`
- URL: `https://hidemail.app/api/v1/aliases`
- Auth: HTTP bearer

This endpoint lets you create a new alias.

## Request body

- object
  - `description` string: Note.

## Response `200`

- object
  - `data` object
    - `email` string
    - `note` string
    - `is_active` boolean
    - `created_at` string
    - `updated_at` string
    - `total_forwarded` integer
    - `total_blocked` integer

---

[API](https://skmtc.dev/hidemail/apis/hidemail-app-api.md) · [All operations](https://skmtc.dev/hidemail/apis/hidemail-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hidemail/apis/hidemail-app-api/revisions/168255500dfd?raw)