> ## 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.
# Benutzerdefinierte Domain hinzufügen
> POST /custom-domain/
Verbindet eine neue benutzerdefinierte Domain mit dem Konto, auf dem **Management-API**-Host (`api.scanova.io`), authentifiziert mit Ihrem rohen Management-API-Schlüssel.
```
POST https://api.scanova.io/custom-domain/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Die zu verbindende Domain, z. B. `links.example.com`. Ein Schema-Präfix, ein abschließender Schrägstrich und Groß-/Kleinschreibung werden automatisch normalisiert — senden Sie sie in beliebiger Form.
```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"
}
```
Das Hinzufügen einer Domain verifiziert sie nicht — `txt_value` und `cname_target` in der Antwort sind die DNS-Einträge, die Sie (oder der Domaininhaber) noch hinzufügen müssen, und `is_txt_verified`/`is_cname_verified` starten mit `false`. Scanova prüft direkt nach der Erstellung asynchron, ob der Registrar der Domain die Ein-Klick-Einrichtung über Domain Connect unterstützt; `domain_connect_supported` spiegelt das Ergebnis wider, sobald diese Prüfung abgeschlossen ist.
`400`, wenn die Domain ungültig oder bereits mit einem beliebigen Konto verbunden ist (die Eindeutigkeitsprüfung ist Groß-/Kleinschreibung-unabhängig). `403`, wenn dem Konto die Quota `CUSTOM_DOMAIN` fehlt, der Plan inaktiv ist, die Berechtigung `CUSTOM_DOMAIN_CAN_ADD` fehlt, oder das Domain-Limit erreicht ist.
## Verwandte Themen
* [Benutzerdefinierte Domains auflisten](/de/api-reference/management-api/custom-domain/list) — verbundene Domains ansehen.
* [DNS-Einträge einer benutzerdefinierten Domain verifizieren](/de/api-reference/management-api/custom-domain/verify) — die Einträge nach dem Hinzufügen prüfen.
* [Domain-Connect-Einrichtungslink abrufen](/de/api-reference/management-api/custom-domain/domain-connect-link) — Ein-Klick-DNS-Einrichtung, sofern unterstützt.
* [DNS-Einrichtungsanweisungen per E-Mail senden](/de/api-reference/management-api/custom-domain/send-instructions) — die manuellen Schritte an jemand anderen weitergeben.
* [Übersicht über die Management API](/de/api-reference/management-api/overview) — das Authentifizierungsschema und die Quota-Regeln für diesen Endpunkt.
## 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.
````