---
title: "Crée un lien court. Sans `parentId`, c'est un lien parent et `destination` est obligatoire. Avec `parentId`, c'est un placement : il hérite de la destination du parent et porte ses propres UTM. Renvoie `shortUrl`, prêt à publier."
method: POST
path: "/api/v1/links"
tags: ["links"]
---

# Crée un lien court. Sans \`parentId\`, c'est un lien parent et \`destination\` est obligatoire. Avec \`parentId\`, c'est un placement : il hérite de la destination du parent et porte ses propres UTM. Renvoie \`shortUrl\`, prêt à publier.

`POST /api/v1/links`

## Request

- Base URL: `https://subtraq.co`
- URL: `https://subtraq.co/api/v1/links`
- Auth: HTTP bearer

## Request body

- object
  - `space` string, required: Raccourci de l'espace client.
  - `destination` string: URL d'arrivée. Obligatoire pour un parent, interdite pour un placement.
  - `parentId` string: Identifiant du lien parent, pour créer un placement.
  - `slug` string: Raccourci souhaité. Tiré au sort s'il est omis.
  - `label` string: Nom du placement, par exemple « Pub Meta — mars ».
  - `utmSource` string: utm_source du placement.
  - `utmMedium` string: utm_medium du placement.
  - `utmCampaign` string: utm_campaign du placement.
  - `utmTerm` string: utm_term du placement.
  - `utmContent` string: utm_content du placement.
  - `domain` string: Adresse qui porte le lien (« liens.votresite.fr »). Omise = le même choix que l'écran de création : le domaine de marque réservé à l'espace, sinon l'unique domaine de marque du compte, sinon l'adresse offerte de l'espace (« client.sbtq.link ») ; pour un placement, le domaine de son parent. Pour le domaine partagé, le nommer : « sbtq.link » (la valeur `domain` d'un lien partagé). Un domaine de marque doit être vérifié dans le compte, et libre pour cet espace.

## Response `200`

Succès.

## Other responses

- `201`: Créé.
- `400`: Paramètres invalides.
- `401`: Clé absente ou révoquée.
- `402`: Quota de la formule atteint.
- `403`: La clé n'a pas le droit demandé.
- `404`: Introuvable dans ce compte.
- `409`: Conflit — un raccourci déjà pris, par exemple.

---

[API](https://skmtc.dev/subtraq/apis/subtraq-api.md) · [All operations](https://skmtc.dev/subtraq/apis/subtraq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/subtraq/apis/subtraq-api/revisions/1a3dacdd7d28?raw)