---
title: "Create a short link"
method: POST
path: "/api/v1/links"
tags: ["Links.Web"]
---

# Create a short link

`POST /api/v1/links`

## Request

- Base URL: `https://flitlink.com`
- URL: `https://flitlink.com/api/v1/links`
- Auth: none declared

Shortens `url`. Optional: `slug` (3-64 chars, letters/digits/hyphens), `title`, `domain` (one of GET /api/v1/domains). Free plan: 50 links/month (402 + code=free_plan_limit beyond that). Supports an Idempotency-Key header.

## Request body

- CreateLinkBody
  - `url` string, required
  - `slug` string, nullable, required
  - `title` string, nullable, required
  - `domain` string, nullable, required

## Response `200`

OK

---

[API](https://skmtc.dev/flitlink/apis/links-web-v1.md) · [All operations](https://skmtc.dev/flitlink/apis/links-web-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/flitlink/apis/links-web-v1/revisions/3451be90087a?raw)