> ## 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.

# Kalenderereignis-QR-Code

> Erstellen Sie einen QR-Code, der ein Ereignis zu einem Kalender hinzufügt.

## Wofür er gedacht ist

Ein Kalenderereignis-QR-Code fordert das scannende Gerät auf, ein Ereignis direkt in seine Kalender-App zu speichern – mit bereits ausgefülltem Namen, Uhrzeit, Ort und Beschreibung. Es handelt sich um einen **Quick Code** – einen QR-Code für eine direkte Aktion ohne Landingpage. In der App lautet die Kachel dafür: "Prompt the scanner to save an event to their calendar", und die Kachel trägt die Bezeichnung **Event Calendar** (der zugrunde liegende Kategoriename lautet "Calendar Event" – beide bezeichnen denselben Typ).

<Note>
  Calendar Event ist **nur statisch** – für diesen Typ gibt es keine dynamische Option. Nach der Veröffentlichung kann das kodierte Ereignis weder bearbeitet noch nachverfolgt werden; um es zu ändern, erstellen Sie einen neuen QR-Code.
</Note>

## Einen Kalenderereignis-QR-Code erstellen

<Steps>
  <Step title="Create QR Code öffnen und Quick Code auswählen">
    Gehen Sie in der Seitenleiste zu **QR Codes** und klicken Sie dann auf **Create QR Code** (oder navigieren Sie zu `/qr/create`). Klicken Sie auf die Karte **Quick Code**.
  </Step>

  <Step title="Event Calendar auswählen">
    Klicken Sie im Raster der Quick-Code-Typen unter **Event Calendar** im Bereich **Static Only** auf **Configure**. Dadurch öffnet sich das Formular unter `/qr/quick/calendar`.
  </Step>

  <Step title="Die Ereignisdetails eingeben">
    Füllen Sie die Felder aus:

    * **Event name** – erforderlich.
    * **Start date & time** – erforderlich.
    * **End date & time** – optional; falls angegeben, muss es am oder nach dem Startdatum liegen, sonst blockiert eine Inline-Fehlermeldung die Veröffentlichung.
    * **Location** (Platzhalter "1 Infinite Loop, Cupertino, CA") – optional.
    * **Description** – optional, mehrzeilig.
    * **Time zone** – optional, standardmäßig "None (device default)" (die eigene Zeitzone des Geräts des Scannenden).

    <Frame caption="Das Event-Calendar-Quick-Code-Formular mit eingegebenem Ereignisnamen, Start-/Endzeit, Ort und Beschreibung">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/calendar-event/calendar-quick-code-form.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=c22f076b2813dc34e172b7f70dc3f4e3" alt="Event-Calendar-Quick-Code-Formular mit ausgefülltem Ereignisnamen, Start- und Enddatum/-uhrzeit, Ort und Beschreibung, plus einer Live-QR-Vorschau rechts" width="1280" height="728" data-path="images/v2/qr-codes/create/calendar-event/calendar-quick-code-form.png" />
    </Frame>
  </Step>

  <Step title="Veröffentlichen">
    Klicken Sie auf **Publish**. Ein Panel öffnet sich, um den QR-Code zu bestätigen oder umzubenennen (Standard ist der Ereignisname), einen Ordner oder Tags zuzuweisen und das QR-Design anzupassen, bevor Sie bestätigen. Nach der Veröffentlichung können Sie das Design (Farben, Rahmen) über **Edit Design** auf dem Bestätigungsbildschirm erneut aufrufen.
  </Step>
</Steps>

## Erstellung über die API

Um einen Kalenderereignis-QR-Code über die API statt über die Benutzeroberfläche zu erstellen, verwenden Sie die Kategorie-ID `12` (bezeichnet als **Calendar Event**, `allowed_qr_types: "st"` – nur `"st"` ist für `qr_type` gültig), mit einem `info`-Payload folgender Form:

```json theme={null}
{
  "type": "calendar",
  "data": {
    "name": "Product Launch Webinar",
    "startDate": "2026-09-10T15:00",
    "endDate": "2026-09-10T16:00",
    "location": "Online — Zoom",
    "description": "Join us for the launch of our new product line.",
    "timeZone": "Asia/Kolkata"
  }
}
```

Laut Backend-Schema sind nur `name` und `startDate` erforderlich; beide Datumsfelder sind freie Zeichenfolgen ohne vorgeschriebenes Format – das Dashboard-Formular sendet den Rohwert seines `datetime-local`-Eingabefelds (`YYYY-MM-DDTHH:mm`) wie oben gezeigt.

<Note>
  Die Kategorie-ID `12` ("Calendar Event") unterscheidet sich von der Kategorie-ID `20` ("Event"), einer anderen, Page-Builder-basierten Kategorie – verwechseln Sie die beiden nicht.
</Note>

Das vollständige Anfrageschema finden Sie unter [Create QR Code](/v1/api-reference/endpoint/qr_manager/create).

<Note>
  Die Referenztabelle [Category List](/v1/api-reference/references/category-list) listet Calendar Event (oder die anderen ausschließlich als Quick Code verfügbaren Kategorien auf dieser Seite) derzeit nicht auf – die obige ID wurde direkt anhand des Live-Endpunkts `/qr/category/` bestätigt.
</Note>

## Weiterführende Informationen

* [Event-QR-Code](/de/qr-codes/create/event) – die andere, Page-Builder-basierte Kategorie "Event" (Zeitplan, Veranstaltungsort, Tickets) – verwechseln Sie die beiden nicht.
* [Ihren ersten QR-Code erstellen](/de/getting-started/first-qr-code) – eine vollständige Anleitung zum Quick-Code-Ablauf, zu dem dieser Typ gehört.
* [Ordner, Tags & Bulk-Operationen](/de/qr-codes/manage/folders-tags-bulk-operations) – den QR-Code nach der Veröffentlichung organisieren.