# Create a short link (/en/reference/links/create-link)

OpenAPI operation (components in https://api.tebar.app/v1/openapi.json):

```json
[
  {
    "operationId": "createLink",
    "tags": [
      "Links"
    ],
    "summary": "Create a short link",
    "description": "Paid plans (403 plan_feature_unavailable), up to 3 links on Starter, 5 on Basic, 10 on Pro and 25 on Agency (422 link_limit_reached). alias is Pro and Agency only (403 alias_requires_pro) and unique in any letter case (409 alias_taken). Refused with 422 destination_not_allowed (details.reason says which check): links to other shorteners, tbr.ink itself or private networks, online gambling, domains on the Komdigi block list, and destinations Google Web Risk suspects of phishing or malware. The same checks run on a new destination and every day on active links, which are blocked when one fails.\n\nRequires the write scope.",
    "parameters": [
      {
        "name": "Idempotency-Key",
        "in": "header",
        "required": false,
        "description": "1-128 characters of [A-Za-z0-9_-]. The same key gives back the same link (200) instead of a new one.",
        "schema": {
          "type": "string"
        }
      },
      {
        "$ref": "#/components/parameters/TebarProfile"
      }
    ],
    "requestBody": {
      "required": true,
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/CreateLinkRequest"
          }
        }
      }
    },
    "responses": {
      "200": {
        "description": "The link made earlier with this Idempotency-Key.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Link"
            }
          }
        }
      },
      "201": {
        "description": "The new link.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Link"
            }
          }
        }
      },
      "400": {
        "$ref": "#/components/responses/BadRequest"
      },
      "401": {
        "$ref": "#/components/responses/Unauthorized"
      },
      "403": {
        "$ref": "#/components/responses/Forbidden"
      },
      "429": {
        "$ref": "#/components/responses/RateLimited"
      }
    }
  }
]
```