POST
Event anlegen

Authorizations

Authorization
string
header
required

API-Schlüssel aus der Konto-Seite: Authorization: Bearer qt_…

Path Parameters

slug
string
required

Kurzname der Community (aus GET /api/rest/v1/communities)

Body

application/json
title
string
required
Maximum string length: 160
startsAt
string
required

Beginn als Wandzeit, z. B. 2026-11-05T19:00

Pattern: ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?)$
endsAt
string
required

Ende als Wandzeit, z. B. 2026-11-05T21:00

Pattern: ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?)$
timezone
string
required
description
string

HTML, wird wie im Editor bereinigt

Maximum string length: 50000
location
string | null
Maximum string length: 200
url
string<uri> | null
Maximum string length: 500
recurrence
enum<string>
Available options:
none,
weekly,
monthly,
monthly_weekday
recurrenceUntil
string | null

Letzter Tag der Serie (YYYY-MM-DD); null = offen

recurrenceWeeks
integer[] | null

Nur bei recurrence = monthly_weekday und dort Pflicht: Wochen im Monat für den Wochentag des Beginns (1–4, -1 = letzter), z. B. [1] = jeden 1. Sonntag, [3, -1] = jeden 3. und letzten Montag; der Beginn muss in eine davon fallen

Maximum array length: 5
minLevel
integer
Required range: 1 <= x <= 30
planIds
string[] | null

Zugang nur mit einem dieser Pläne (leer = alle); null = beim Anlegen die vorausgewählten Pläne, beim Ändern unverändert

Maximum array length: 20
formId
string<uuid> | null

Formular, das vor der Zusage ausgefüllt sein muss; null = keins

capacity
integer | null

Höchstzahl der Zusagen je Termin; null = unbegrenzt

Required range: 1 <= x <= 100000
waitlistEnabled
boolean

Warteliste bei vollem Termin (nur mit capacity)

ageGroupIds
string[] | null

Zugang nur für diese Altersgruppen (Alters-Tags); null = beim Anlegen keine, beim Ändern unverändert

Maximum array length: 10
tags
string[] | null

Freie Tags (v2.22, bis 10, je bis 30 Zeichen); null = beim Anlegen keine, beim Ändern unverändert

Maximum array length: 10
postalCode
string | null

Postleitzahl des Orts (v2.22); null = beim Anlegen aus dem Ort vorgeschlagen, beim Ändern unverändert; leer = keine

Maximum string length: 16
country
string | null

Land der Postleitzahl (ISO 3166-1 alpha-2); null = Standard-Land der Community

draft
boolean | null

Vorschau (v2.25): true = im Kalender sichtbar, aber ohne Zusagen und Benachrichtigungen; false = veröffentlichen; null = beim Anlegen veröffentlicht, beim Ändern unverändert. Zurück zur Vorschau nur ohne Zusagen, Warteliste und Tickets (sonst 409)

minAttendees
integer | null

Mindestteilnehmerzahl je Termin: ist sie zum Stichtag (minAttendeesDeadline) nicht erreicht, wird der Termin automatisch abgesagt und die Angemeldeten werden benachrichtigt. 0 = keine; null = beim Anlegen keine, beim Ändern unverändert. Mit capacity höchstens so groß wie diese (sonst 422)

Required range: 0 <= x <= 100000
minAttendeesDeadline
object | null

Stichtag der Mindestteilnehmerzahl relativ zum Beginn; Pflicht mit minAttendees (sonst 422); null = beim Ändern unverändert

Response

Angelegt

eventId
string
required
occurrenceStart
string
required

Beginn dieses Termins (ISO 8601, UTC) – identifiziert den Termin einer Serie (occurrence)

occurrenceEnd
string
required
title
string
required
description
string
required

Bereinigtes HTML

timezone
string
required

Zeitzone der Wandzeit (z. B. Europe/Berlin)

location
string | null
required
url
string | null
required
recurrence
enum<string>
required
Available options:
none,
weekly,
monthly,
monthly_weekday
recurrenceUntil
string | null
required

Letzter Tag der Serie (YYYY-MM-DD in der Event-Zeitzone); null = offen

minLevel
integer
required
planIds
string[]
required

Zugang nur mit einem dieser Pläne (leer = alle Mitglieder)

planNames
string[]
required
ageGroupIds
string[]
required

Zugang nur für diese Altersgruppen (leer = alle)

ageGroupNames
string[]
required
formId
string | null
required

Formular, das vor der Zusage ausgefüllt sein muss

formName
string | null
required
capacity
integer | null
required

Höchstzahl der Zusagen je Termin; null = unbegrenzt

spotsLeft
integer | null
required

Freie Plätze; null = unbegrenzt

rsvpCount
integer
required
waitlistEnabled
boolean
required
waitlistCount
integer
required
createdByName
string | null
required
webUrl
string
required

Termin in der Oberfläche

tags
string[]
required

Freie Tags (v2.22)

postalCode
string | null
required

Postleitzahl des Orts (v2.22, Entfernungen); null ohne Angabe

country
string | null
required

Land der Postleitzahl (ISO 3166-1 alpha-2)

recurrenceWeeks
integer[]
required

Bei recurrence = monthly_weekday die Wochen im Monat (1–4, -1 = letzter) für den Wochentag des Beginns; sonst leer

draft
boolean
required

Vorschau (v2.25): im Kalender sichtbar (mit Zusatz „(Entwurf)“ am Titel), aber ohne Zusagen und Benachrichtigungen

minAttendees
integer | null
required

Mindestteilnehmerzahl je Termin; null = keine

minAttendeesDeadlineAt
string | null
required

Stichtag dieses Termins (ISO 8601, UTC): dann wird die Mindestteilnehmerzahl geprüft und der Termin bei zu wenigen Zusagen automatisch abgesagt; null ohne Mindestzahl

minAttendeesState
string
required

Stand der Prüfung: none (keine Mindestzahl) | pending (steht aus) | reached (erreicht, der Termin findet statt) | missed (nicht erreicht, automatisch abgesagt) | closed (wird nicht geprüft)

minAttendeesMissing
integer | null
required

Zusagen, die bis zur Mindestzahl noch fehlen – nur solange die Prüfung aussteht (pending); sonst null

cancelled
boolean
required

Dieser Termin ist abgesagt (von Hand oder weil die Mindestteilnehmerzahl nicht erreicht war); Zusagen bleiben gespeichert

cancellationKind
string | null
required

Art der Absage: min_attendees (automatisch zum Stichtag) | manual (von Hand); null, wenn der Termin stattfindet

cancellationReason
string | null
required

Grund einer Absage von Hand (reiner Text); null ohne Angabe

cancelledAt
string | null
required

Zeitpunkt der Absage (ISO 8601, UTC); null, wenn der Termin stattfindet