---
title: "Create a media link"
method: POST
path: "/media-links"
---

# Create a media link

`POST /media-links`

Create a shareable media link that bundles one or more vault media items for a single unlock price. All referenced media must be owned by the creator. Amounts are integer minor units of the currency (e.g. cents: 1999 = $19.99). Requires media links to be enabled.

## Headers

- `X-Fanvue-API-Version` string, required

## Request body

- object
  - `mediaUuids` string[], required — UUIDs of the vault media items to bundle into the link. All must be owned by the creator.
  - `price` integer, required — Price fans pay to unlock the media, in integer minor units of the currency (e.g. cents: 1999 = $19.99). Must be between 300 and 50000 minor units. Note: the Fanvue dashboard displays prices in major units; this API always uses integer minor units.

## Response `201`

Media link created successfully

- object
  - `uuid` string, uuid, required — Media link UUID
  - `url` string, nullable, required — Shareable URL fans use to unlock the media
  - `price` integer, required — Price in integer minor units of the currency (e.g. cents) fans pay to unlock
  - `mediaUuids` string[], required — UUIDs of the media items bundled into the link, oldest first
  - `clicks` integer, required — Number of times the link has been viewed
  - `unlocks` integer, required — Number of paid unlocks (completed purchases)
  - `earnings` integer, required — Total gross earnings from the link, in integer minor units of the currency
  - `createdAt` string, date-time, required — When the link was created

## Other responses

- `400` — Bad Request - API version not supported OR validation failed
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `404` — Not Found Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded

---

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