> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Ajouter un domaine personnalisé
> POST /custom-domain/
Connecte un nouveau domaine personnalisé au compte, sur l'hôte de l'**API de gestion** (`api.scanova.io`), authentifié avec votre clé d'API de gestion brute.
```
POST https://api.scanova.io/custom-domain/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Le domaine à connecter, par ex. `links.example.com`. Un préfixe de schéma, une barre oblique finale et la casse sont tous normalisés automatiquement — envoyez-le comme vous le souhaitez.
```bash cURL theme={null}
curl -X POST "https://api.scanova.io/custom-domain/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "domain": "links.example.com" }'
```
```json 201 theme={null}
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": false,
"is_cname_verified": false,
"is_migrated": false,
"dns_provider": { "name": "Cloudflare", "placeholders": { "cname": { "content": { "label": "Target" } } } },
"txt_error": null,
"cname_error": null,
"root_action": "no_action",
"redirect": null,
"template": null,
"protocol": "https",
"remove_qr_query": false,
"cname_target": "shortcname.scanova.io",
"domain_connect_supported": false,
"domain_connect_checked_at": null,
"created": "2026-09-08T10:00:00Z",
"modified": "2026-09-08T10:00:00Z"
}
```
Ajouter un domaine ne le vérifie pas — `txt_value` et `cname_target` dans la réponse sont les enregistrements DNS que vous (ou le propriétaire du domaine) devez encore ajouter, et `is_txt_verified`/`is_cname_verified` démarrent à `false`. Scanova vérifie de manière asynchrone, juste après la création, si le registraire du domaine prend en charge la configuration en un clic via Domain Connect ; `domain_connect_supported` reflète le résultat une fois cette vérification terminée.
`400` si le domaine est invalide ou déjà connecté à un compte quelconque (la vérification d'unicité ne tient pas compte de la casse). `403` si le compte n'a pas le quota `CUSTOM_DOMAIN`, a un plan inactif, n'a pas la permission `CUSTOM_DOMAIN_CAN_ADD`, ou a atteint sa limite de domaines.
## Voir aussi
* [Lister les domaines personnalisés](/fr/api-reference/management-api/custom-domain/list) — voir les domaines connectés.
* [Vérifier les enregistrements DNS d'un domaine personnalisé](/fr/api-reference/management-api/custom-domain/verify) — vérifier les enregistrements une fois ajoutés.
* [Obtenir un lien de configuration Domain Connect](/fr/api-reference/management-api/custom-domain/domain-connect-link) — configuration DNS en un clic, si prise en charge.
* [Envoyer les instructions de configuration DNS par e-mail](/fr/api-reference/management-api/custom-domain/send-instructions) — déléguer les étapes manuelles à quelqu'un d'autre.
* [Présentation de l'API de gestion](/fr/api-reference/management-api/overview) — le schéma d'authentification et les règles de quota applicables à cet endpoint.
## OpenAPI
````yaml api-reference/openapi/management-api.json POST /custom-domain/
openapi: 3.1.0
info:
title: Scanova Management API (v2)
description: >-
The complete Scanova Management API — every endpoint available at
api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
shared users & roles), plus the token-creation and usage-stats endpoints
used to authenticate against it. Every path and request/response shape below
was verified live against a real API key and the actual running backend
(Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
version: 2.0.0
servers:
- url: https://api.scanova.io
description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
- apiKeyAuth: []
paths:
/custom-domain/:
post:
summary: Add a custom domain
description: >-
Requires the CUSTOM_DOMAIN plan quota and CUSTOM_DOMAIN_CAN_ADD
permission, plus an active plan. Triggers async Domain Connect support
discovery.
operationId: createCustomDomain
requestBody:
content:
application/json:
example:
domain: links.example.com
responses:
'201':
description: Domain added.
content:
application/json:
example:
id: 42
domain: https://links.example.com
is_default: false
disable_slug_case: false
txt_value: scanova-verification=abc123...
is_txt_verified: false
is_cname_verified: false
is_migrated: false
dns_provider:
name: Cloudflare
placeholders:
cname:
content:
label: Target
txt_error: null
cname_error: null
root_action: no_action
redirect: null
template: null
protocol: https
remove_qr_query: false
cname_target: shortcname.scanova.io
domain_connect_supported: false
domain_connect_checked_at: null
created: '2026-09-08T10:00:00Z'
modified: '2026-09-08T10:00:00Z'
'400':
description: Invalid or duplicate domain (case-insensitive uniqueness check).
'403':
description: >-
Missing CUSTOM_DOMAIN quota, inactive plan, missing
CUSTOM_DOMAIN_CAN_ADD permission, or domain limit reached.
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
Send your Management API key as the raw value of the Authorization
header — no "Bearer " or "Token " prefix, and no other characters.
Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
header containing more than one space-separated part is rejected
outright. Requests also require the request's Host header to be the
management API host (e.g. api.scanova.io) — the same key sent to the
regular API host will not authenticate.
````