---
title: "Create alias"
method: POST
path: "/aliases"
tags: ["Alias"]
---

# Create alias

`POST /aliases`

This POST method creates a new alias under a specified domain. If no domain is specified in the request the alias will be attached to the default domain Short.fyi 

 **NOTE:** You can override the domain level Meta Tags and Tracking Snippets by specifying them for each URL. Any variables you add to a specific URL will always override domain level settings.

## Query parameters

- `domainName` string
- `aliasName` string

## Request body

- CreateAliasModel
  - `destinations` DestinationModel[]
    - `country` string — ISO alpha-2 [country code](//en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)
    - `os` string — Please check the [supported OS list](#tag/OperatingSystems)
    - `url` string, required
  - `metatags` MetaTagModel[]
    - `name` string, required
    - `content` string, required
  - `snippets` SnippetModel[]
    - `id` string, required — Please check the [supported snippets list](#tag/Snippets)
    - `parameters` object

## Response `200`

Response contains aliasName, domainName and full generated short link

- CreateAliasResponseModel
  - `aliasName` string
  - `domainName` string
  - `shortUrl` string

---

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