> ## Documentation Index
> Fetch the complete documentation index at: https://docs.netzfabrik.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Anmelden (JWT ausstellen)

> Meldet einen Benutzer mit E-Mail-Adresse und Passwort an. Ohne zweiten Faktor enthält die Antwort ein Token-Paar:

- `token`: Access-Token (JWT), bei jeder Anfrage als `Authorization: Bearer <token>` senden. Es ist zeitlich begrenzt gültig.
- `refresh_token`: damit holt `POST /auth/token/refresh` ein neues Token-Paar.

**Zweiter Faktor.** Ist für das Konto TOTP oder ein Passkey aktiv, enthält die Antwort statt des Token-Paars `mfaRequired: true`, ein kurzlebiges `preAuthToken` (Gültigkeit in Sekunden in `expiresIn`) und die möglichen Verfahren in `methods`. Bestätige den Faktor mit `POST /auth/2fa/verify` und dem `preAuthToken` als Bearer-Token. Schreibt eine Richtlinie einen zweiten Faktor vor, der noch nicht eingerichtet ist, kommt `mfaEnrollmentRequired: true`; mit dem `preAuthToken` sind dann nur die Einrichtungs-Endpunkte erreichbar.

Nach fünf Fehlversuchen innerhalb von 15 Minuten (je E-Mail-Adresse und IP) antwortet der Endpunkt mit `429 Too Many Requests`. Für Skripte und Server-Integrationen empfehlen wir statt Passwort-Login einen API-Token (`X-API-TOKEN`).



## OpenAPI

````yaml /api-reference/openapi.json post /auth/login
openapi: 3.1.0
info:
  title: NETZFABRIK API
  description: >-
    REST-API der NETZFABRIK-Plattform für Domains, DNS, Cloud-Server, Webspaces,
    E-Mail-Dienste und Konto. Authentifizierung per JWT (Authorization: Bearer)
    oder API-Token (X-API-TOKEN).
  termsOfService: https://www.netzfabrik.com/tos
  contact:
    name: NETZFABRIK GmbH
    url: https://www.netzfabrik.com
    email: info@netzfabrik.com
  license:
    name: Proprietary
    url: https://www.netzfabrik.com/license
  version: 2026-11-19-9237c1a3
servers:
  - url: https://api.netzfabrik.com
security:
  - JWT: []
  - ApiToken: []
tags:
  - name: Login
  - name: Zwei-Faktor-Authentifizierung
  - name: Passkeys
  - name: Benutzer
  - name: Konten
  - name: Kunden
  - name: Verträge
  - name: Rechnungen
  - name: Support-Tickets
  - name: Domains
  - name: Domain-Bestellungen
  - name: Premium-Domains
  - name: Inhaberwechsel
  - name: Handles (Kontakte)
  - name: Handle-Verifizierung
  - name: TLD-Daten
  - name: Domain-Preise
  - name: Preislisten-Vorlagen
  - name: Preislisten-Versionen
  - name: Preis-Überschreibungen
  - name: Preisänderungen
  - name: Domain-Aktionen
  - name: Öffentliche Preislisten
  - name: Domain-Reseller
  - name: DNS-Zonen
  - name: DNS-Records
  - name: Weiterleitungen
  - name: Cloud-Server
  - name: Cloud-Server-Vorlagen
  - name: Regionen
  - name: SSH-Keys
  - name: ISO-Images
  - name: Anwendungen
  - name: Webspaces
  - name: Webspace-Tarife
  - name: Object Storage
  - name: E-Mail-Protection
  - name: E-Mail-Security
  - name: E-Mail-Archiv
  - name: Colocation
  - name: Racks
  - name: Stromzuführungen
  - name: Interconnections
  - name: VLANs
  - name: Traffic
paths:
  /auth/login:
    post:
      tags:
        - Login
      summary: Anmelden (JWT ausstellen)
      description: >-
        Meldet einen Benutzer mit E-Mail-Adresse und Passwort an. Ohne zweiten
        Faktor enthält die Antwort ein Token-Paar:


        - `token`: Access-Token (JWT), bei jeder Anfrage als `Authorization:
        Bearer <token>` senden. Es ist zeitlich begrenzt gültig.

        - `refresh_token`: damit holt `POST /auth/token/refresh` ein neues
        Token-Paar.


        **Zweiter Faktor.** Ist für das Konto TOTP oder ein Passkey aktiv,
        enthält die Antwort statt des Token-Paars `mfaRequired: true`, ein
        kurzlebiges `preAuthToken` (Gültigkeit in Sekunden in `expiresIn`) und
        die möglichen Verfahren in `methods`. Bestätige den Faktor mit `POST
        /auth/2fa/verify` und dem `preAuthToken` als Bearer-Token. Schreibt eine
        Richtlinie einen zweiten Faktor vor, der noch nicht eingerichtet ist,
        kommt `mfaEnrollmentRequired: true`; mit dem `preAuthToken` sind dann
        nur die Einrichtungs-Endpunkte erreichbar.


        Nach fünf Fehlversuchen innerhalb von 15 Minuten (je E-Mail-Adresse und
        IP) antwortet der Endpunkt mit `429 Too Many Requests`. Für Skripte und
        Server-Integrationen empfehlen wir statt Passwort-Login einen API-Token
        (`X-API-TOKEN`).
      operationId: login_check_post
      requestBody:
        description: The login data
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                password:
                  type: string
              required:
                - email
                - password
            example:
              email: max.mustermann@example.com
              password: S1cheres-Passw0rt
        required: true
      responses:
        '200':
          description: User token created
          content:
            application/json:
              schema:
                type: object
                properties:
                  token:
                    readOnly: true
                    type: string
                required:
                  - token
      security: []
components:
  securitySchemes:
    JWT:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Access-Token aus `POST /auth/login` (E-Mail und Passwort), gesendet als
        `Authorization: Bearer <token>`.


        Das Token ist zeitlich begrenzt gültig. Mit dem `refresh_token` aus
        derselben Antwort holt `POST /auth/token/refresh` ein neues Token-Paar,
        ohne das Passwort erneut zu senden; `POST /auth/token/invalidate` macht
        den Refresh-Token beim Abmelden ungültig.


        Ist für das Konto ein zweiter Faktor aktiv oder vorgeschrieben, liefert
        der Login statt des Token-Paars `mfaRequired: true` bzw.
        `mfaEnrollmentRequired: true` und ein kurzlebiges `preAuthToken`. Mit
        diesem Token (ebenfalls als Bearer) wird der zweite Faktor über `POST
        /auth/2fa/verify` bestätigt; erst danach gibt es das volle Token-Paar.
    ApiToken:
      type: apiKey
      in: header
      name: X-API-TOKEN
      description: >-
        Persönlicher API-Token für Skripte, CI/CD und
        Server-zu-Server-Integrationen, gesendet im Header `X-API-TOKEN:
        <token>`.


        Tokens werden im Kundenpanel unter **Einstellungen → Sicherheit**
        angelegt oder per `POST /user/api-tokens` mit einem gültigen JWT. Der
        Klartext erscheint nur einmal in der Antwort beim Anlegen. Ein Token
        handelt mit den Rechten des Benutzers, der ihn erstellt hat, kann ein
        Ablaufdatum haben und wird mit `DELETE /user/api-tokens/{id}` sofort
        widerrufen.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.