---
title: "Create a short link"
method: POST
path: "/v1/short-links"
tags: ["Link shortener"]
---

# Create a short link

`POST /v1/short-links`

Creates a short link that redirects to the target URL and tracks click metrics.

## Request body

- ShortLinkCreateRequest
  - `link` string, required — Target URL to shorten.
  - `expiration_time` string, date-time — Expiration date and time in ISO 8601 format.
  - `fallback_url` string — Fallback URL for expired or invalid links.
  - `phone` string — Phone number for the short link.
  - `utm_campaign` string — UTM campaign name for tracking insights.

## Response `200`

Returns the created short link.

- ShortLinkResponse
  - `short_link` string, required — Generated short URL.

## Other responses

- `400` — Request failed. Missing or invalid parameter <param_name>
- `403` — Request failed. The feature is disabled for your account.
- `404` — Request failed. An object with the specified ID is not found.
- `422` — Returns a validation error when a field value is invalid.

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/revisions/b22f170488b6/schema)