---
title: "CreateLink"
method: POST
path: "/links"
---

# CreateLink

`POST /links`

Creates a link. Both the new link and the user are returned so that newly created tags can be seen.

## Request body

- LinkCreateLinkRequest
  - `corpus` string
  - `description` string
  - `favicon` string
  - `image` string
  - `site` string
  - `title` string
  - `url` string, required

## Response `201`

Created

- LinkCreateLinkResponse
  - `link` ModelLink
    - `annotation` string
    - `corpus` string
    - `createdAt` string
    - `description` string
    - `favicon` string
    - `folderId` string
    - `id` string
    - `image` string
    - `isAnnotated` boolean
    - `isFavorite` boolean
    - `site` string
    - `tagDetails` ModelTagDetail[]
      - `confidence` number
      - `name` string
      - `path` string
    - `tagPaths` string[]
    - `title` string
    - `updatedAt` string
    - `url` string
    - `userId` string
  - `user` ModelUser
    - `createdAt` string
    - `email` string
    - `firstName` string
    - `folderTree` ModelFolder
      - `children` ModelFolder[]
      - `id` string
      - `name` string
    - `hasSeenWelcomeTour` boolean
    - `id` string
    - `lastName` string
    - `tagTree` ModelTagNode
      - `children` ModelTagNode[]
      - `count` integer
      - `name` string
      - `path` string
    - `token` string
    - `updatedAt` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

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