Cal.com ist eine flexible Planungsplattform, die es einfach macht, Termine, Buchungen, Veranstaltungstypen und Teamverfügbarkeiten zu verwalten.
Mit Cal.com können Sie:
- Planung automatisieren: Ermöglichen Sie Nutzern, Ihre verfügbaren Zeitfenster einzusehen und Meetings automatisch zu buchen, ohne E-Mail-Pingpong.
- Veranstaltungen verwalten: Erstellen und passen Sie Veranstaltungstypen, Dauern und Regeln für Einzel- oder Gruppenmeetings an.
- Kalender integrieren: Verbinden Sie sich nahtlos mit Google, Outlook, Apple oder anderen Kalenderanbietern, um Doppelbuchungen zu vermeiden.
- Teilnehmer und Gäste verwalten: Erfassen Sie Teilnehmerinformationen, verwalten Sie Gäste und versenden Sie Einladungen oder Erinnerungen.
- Verfügbarkeit steuern: Definieren Sie individuelle Arbeitszeiten, Pufferzeiten und Storno-/Umbuchungsregeln.
- Workflows automatisieren: Lösen Sie benutzerdefinierte Aktionen über Webhooks aus, wenn eine Buchung erstellt, storniert oder umgebucht wird.
In Aptlystar ermöglicht die Cal.com-Integration Ihren Agenten, Meetings zu buchen, Verfügbarkeiten zu prüfen, Veranstaltungstypen zu verwalten und Planungsaufgaben programmatisch zu automatisieren. Dies hilft Agenten, Meetings zu koordinieren, Buchungen im Namen von Nutzern zu versenden, Zeitpläne zu prüfen oder auf Buchungsereignisse zu reagieren – alles ohne manuelle Eingriffe. Durch die Verbindung von Aptlystar mit Cal.com erschließen Sie hochautomatisierte und intelligente Planungs-Workflows, die sich nahtlos in Ihre umfassenderen Automatisierungsanforderungen integrieren lassen.
Integrieren Sie Cal.com in Ihren Workflow. Erstellen und verwalten Sie Buchungen, Veranstaltungstypen, Zeitpläne und prüfen Sie Verfügbarkeitsfenster. Unterstützt das Erstellen, Auflisten, Umbuchen und Stornieren von Buchungen sowie die Verwaltung von Veranstaltungstypen und Zeitplänen. Kann auch Workflows basierend auf Cal.com-Webhook-Ereignissen auslösen (Buchung erstellt, storniert, umgebucht). Verbinden Sie Ihr Cal.com-Konto über OAuth.
Eine neue Buchung auf Cal.com erstellen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
eventTypeId | number | Ja | Die ID des zu buchenden Ereignistyps |
start | string | Ja | Startzeit im UTC ISO 8601-Format (z. B. 2024-01-15T09:00:00Z) |
attendee | object | Ja | Teilnehmerinformationsobjekt mit Name, E-Mail, Zeitzone und optionaler Telefonnummer (zusammengestellt aus einzelnen Teilnehmerfeldern) |
guests | array | Nein | Array von Gast-E-Mail-Adressen |
items | string | Nein | Gast-E-Mail-Adresse |
lengthInMinutes | number | Nein | Dauer der Buchung in Minuten (überschreibt die Standardeinstellung des Ereignistyps) |
metadata | object | Nein | Benutzerdefinierte Metadaten, die an die Buchung angehängt werden |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Details der erstellten Buchung |
↳ eventType | object | Details des Ereignistyps |
↳ id | number | Ereignistyp-ID |
↳ slug | string | Ereignistyp-Slug |
↳ attendees | array | Liste der Teilnehmer |
↳ name | string | Name des Teilnehmers |
↳ email | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ timeZone | string | Zeitzone des Teilnehmers (IANA-Format) |
↳ phoneNumber | string | Telefonnummer des Teilnehmers |
↳ language | string | Sprachpräferenz des Teilnehmers (ISO-Code) |
↳ absent | boolean | Ob der Teilnehmer abwesend war |
↳ hosts | array | Liste der Gastgeber |
↳ id | number | Benutzer-ID des Gastgebers |
↳ name | string | Anzeigename des Gastgebers |
↳ email | string | Tatsächliche E-Mail-Adresse des Gastgebers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ username | string | Cal.com-Benutzername des Gastgebers |
↳ timeZone | string | Zeitzone des Gastgebers (IANA-Format) |
↳ id | number | Numerische Buchungs-ID |
↳ uid | string | Eindeutige Kennung für die Buchung |
↳ title | string | Titel der Buchung |
↳ status | string | Buchungsstatus (z. B. akzeptiert, ausstehend, storniert) |
↳ start | string | Startzeit im ISO 8601-Format |
↳ end | string | Endzeit im ISO 8601-Format |
↳ duration | number | Dauer in Minuten |
↳ eventTypeId | number | Ereignistyp-ID |
↳ meetingUrl | string | URL zum Beitritt zum Meeting |
↳ location | string | Ort der Buchung |
↳ absentHost | boolean | Ob der Gastgeber abwesend war |
↳ guests | array | Gast-E-Mail-Adressen |
↳ bookingFieldsResponses | json | Benutzerdefinierte Buchungsfeldantworten (dynamische Schlüssel basierend auf der Ereignistyp-Konfiguration) |
↳ metadata | json | Benutzerdefinierte Metadaten, die an die Buchung angehängt sind (dynamische Schlüssel-Wert-Paare) |
↳ icsUid | string | ICS-Kalender-UID |
↳ createdAt | string | Zeitpunkt der Erstellung der Buchung |
Details einer bestimmten Buchung anhand ihrer UID abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
bookingUid | string | Ja | Eindeutige Kennung (UID) der Buchung |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Buchungsdetails |
↳ eventType | object | Details zum Ereignistyp |
↳ id | number | Ereignistyp-ID |
↳ slug | string | Ereignistyp-Slug |
↳ attendees | array | Liste der Teilnehmer |
↳ name | string | Name des Teilnehmers |
↳ email | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ timeZone | string | Zeitzone des Teilnehmers (IANA-Format) |
↳ phoneNumber | string | Telefonnummer des Teilnehmers |
↳ language | string | Sprachpräferenz des Teilnehmers (ISO-Code) |
↳ absent | boolean | Ob der Teilnehmer abwesend war |
↳ hosts | array | Liste der Gastgeber |
↳ id | number | Benutzer-ID des Gastgebers |
↳ name | string | Anzeigename des Gastgebers |
↳ email | string | Tatsächliche E-Mail-Adresse des Gastgebers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ username | string | Cal.com-Benutzername des Gastgebers |
↳ timeZone | string | Zeitzone des Gastgebers (IANA-Format) |
↳ id | number | Numerische Buchungs-ID |
↳ uid | string | Eindeutige Kennung für die Buchung |
↳ title | string | Titel der Buchung |
↳ description | string | Beschreibung der Buchung |
↳ status | string | Buchungsstatus (z. B. akzeptiert, ausstehend, storniert) |
↳ start | string | Startzeit im ISO-8601-Format |
↳ end | string | Endzeit im ISO-8601-Format |
↳ duration | number | Dauer in Minuten |
↳ eventTypeId | number | Ereignistyp-ID |
↳ meetingUrl | string | URL zum Beitritt zum Meeting |
↳ location | string | Ort der Buchung |
↳ absentHost | boolean | Ob der Gastgeber abwesend war |
↳ guests | array | E-Mail-Adressen der Gäste |
↳ bookingFieldsResponses | json | Benutzerdefinierte Buchungsfeld-Antworten (dynamische Schlüssel basierend auf der Ereignistyp-Konfiguration) |
↳ metadata | json | Benutzerdefinierte Metadaten, die der Buchung angehängt sind (dynamische Schlüssel-Wert-Paare) |
↳ rating | number | Buchungsbewertung |
↳ icsUid | string | ICS-Kalender-UID |
↳ cancellationReason | string | Grund für die Stornierung, falls storniert |
↳ reschedulingReason | string | Grund für die Umbuchung, falls umgebucht |
↳ rescheduledFromUid | string | Ursprüngliche Buchungs-UID, falls diese Buchung umgebucht wurde |
↳ rescheduledToUid | string | Neue Buchungs-UID nach Umbuchung |
↳ cancelledByEmail | string | E-Mail der Person, die die Buchung storniert hat |
↳ rescheduledByEmail | string | E-Mail der Person, die die Buchung umgebucht hat |
↳ createdAt | string | Zeitpunkt der Erstellung der Buchung |
↳ updatedAt | string | Zeitpunkt der letzten Aktualisierung der Buchung |
Alle Buchungen mit optionalem Statusfilter auflisten
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
status | string | Nein | Buchungen nach Status filtern: upcoming, recurring, past, cancelled oder unconfirmed |
take | number | Nein | Anzahl der zurückzugebenden Buchungen (Paginierungslimit) |
skip | number | Nein | Anzahl der zu überspringenden Buchungen (Paginierungsoffset) |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | array | Array von Buchungen |
↳ eventType | object | Details zum Ereignistyp |
↳ id | number | Ereignistyp-ID |
↳ slug | string | Ereignistyp-Slug |
↳ attendees | array | Liste der Teilnehmer |
↳ name | string | Name des Teilnehmers |
↳ email | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ timeZone | string | Zeitzone des Teilnehmers (IANA-Format) |
↳ phoneNumber | string | Telefonnummer des Teilnehmers |
↳ language | string | Sprachpräferenz des Teilnehmers (ISO-Code) |
↳ absent | boolean | Ob der Teilnehmer abwesend war |
↳ hosts | array | Liste der Gastgeber |
↳ id | number | Benutzer-ID des Gastgebers |
↳ name | string | Anzeigename des Gastgebers |
↳ email | string | Tatsächliche E-Mail-Adresse des Gastgebers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ username | string | Cal.com-Benutzername des Gastgebers |
↳ timeZone | string | Zeitzone des Gastgebers (IANA-Format) |
↳ id | number | Numerische Buchungs-ID |
↳ uid | string | Eindeutige Kennung für die Buchung |
↳ title | string | Titel der Buchung |
↳ description | string | Beschreibung der Buchung |
↳ status | string | Buchungsstatus (z. B. accepted, pending, cancelled) |
↳ start | string | Startzeit im ISO-8601-Format |
↳ end | string | Endzeit im ISO-8601-Format |
↳ duration | number | Dauer in Minuten |
↳ eventTypeId | number | Ereignistyp-ID |
↳ meetingUrl | string | URL zum Beitritt zum Meeting |
↳ location | string | Ort der Buchung |
↳ absentHost | boolean | Ob der Gastgeber abwesend war |
↳ guests | array | E-Mail-Adressen der Gäste |
↳ bookingFieldsResponses | json | Antworten auf benutzerdefinierte Buchungsfelder (dynamische Schlüssel basierend auf der Ereignistyp-Konfiguration) |
↳ metadata | json | Benutzerdefinierte Metadaten, die der Buchung zugeordnet sind (dynamische Schlüssel-Wert-Paare) |
↳ rating | number | Buchungsbewertung |
↳ icsUid | string | ICS-Kalender-UID |
↳ cancellationReason | string | Grund für die Stornierung, falls storniert |
↳ cancelledByEmail | string | E-Mail der Person, die die Buchung storniert hat |
↳ reschedulingReason | string | Grund für die Umbuchung, falls umgebucht |
↳ rescheduledByEmail | string | E-Mail der Person, die die Buchung umgebucht hat |
↳ rescheduledFromUid | string | Ursprüngliche Buchungs-UID, falls diese Buchung umgebucht wurde |
↳ rescheduledToUid | string | Neue Buchungs-UID nach Umbuchung |
↳ createdAt | string | Zeitpunkt der Erstellung der Buchung |
↳ updatedAt | string | Zeitpunkt der letzten Aktualisierung der Buchung |
pagination | object | Paginierungs-Metadaten |
↳ totalItems | number | Gesamtanzahl der Elemente |
↳ remainingItems | number | Verbleibende Elemente nach der aktuellen Seite |
↳ returnedItems | number | Anzahl der in dieser Antwort zurückgegebenen Elemente |
↳ itemsPerPage | number | Elemente pro Seite |
↳ currentPage | number | Aktuelle Seitennummer |
↳ totalPages | number | Gesamtanzahl der Seiten |
↳ hasNextPage | boolean | Ob es eine nächste Seite gibt |
↳ hasPreviousPage | boolean | Ob es eine vorherige Seite gibt |
Eine bestehende Buchung stornieren
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
bookingUid | string | Ja | Eindeutige Kennung (UID) der zu stornierenden Buchung |
cancellationReason | string | Nein | Grund für die Stornierung der Buchung |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Details der stornierten Buchung |
↳ eventType | object | Details des Ereignistyps |
↳ id | number | Ereignistyp-ID |
↳ slug | string | Ereignistyp-Slug |
↳ attendees | array | Liste der Teilnehmer |
↳ name | string | Name des Teilnehmers |
↳ email | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ timeZone | string | Zeitzone des Teilnehmers (IANA-Format) |
↳ phoneNumber | string | Telefonnummer des Teilnehmers |
↳ language | string | Sprachpräferenz des Teilnehmers (ISO-Code) |
↳ absent | boolean | Ob der Teilnehmer abwesend war |
↳ hosts | array | Liste der Gastgeber |
↳ id | number | Benutzer-ID des Gastgebers |
↳ name | string | Anzeigename des Gastgebers |
↳ email | string | Tatsächliche E-Mail-Adresse des Gastgebers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ username | string | Cal.com-Benutzername des Gastgebers |
↳ timeZone | string | Zeitzone des Gastgebers (IANA-Format) |
↳ id | number | Numerische Buchungs-ID |
↳ uid | string | Eindeutige Kennung für die Buchung |
↳ title | string | Titel der Buchung |
↳ cancellationReason | string | Grund für die Stornierung, falls storniert |
↳ cancelledByEmail | string | E-Mail der Person, die die Buchung storniert hat |
↳ start | string | Startzeit im ISO-8601-Format |
↳ end | string | Endzeit im ISO-8601-Format |
↳ duration | number | Dauer in Minuten |
↳ eventTypeId | number | Ereignistyp-ID |
↳ location | string | Ort der Buchung |
↳ metadata | json | Benutzerdefinierte Metadaten, die der Buchung zugeordnet sind (dynamische Schlüssel-Wert-Paare) |
↳ createdAt | string | Zeitpunkt der Erstellung der Buchung |
↳ status | string | Buchungsstatus (sollte storniert sein) |
Eine bestehende Buchung auf einen neuen Zeitpunkt verschieben
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
bookingUid | string | Ja | Eindeutige Kennung (UID) der zu verschiebenden Buchung |
start | string | Ja | Neue Startzeit im UTC ISO 8601-Format (z. B. 2024-01-15T09:00:00Z) |
reschedulingReason | string | Nein | Grund für die Verschiebung der Buchung |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Details der verschobenen Buchung |
↳ eventType | object | Details des Ereignistyps |
↳ id | number | Ereignistyp-ID |
↳ slug | string | Ereignistyp-Slug |
↳ attendees | array | Liste der Teilnehmer |
↳ name | string | Name des Teilnehmers |
↳ email | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ timeZone | string | Zeitzone des Teilnehmers (IANA-Format) |
↳ phoneNumber | string | Telefonnummer des Teilnehmers |
↳ language | string | Sprachpräferenz des Teilnehmers (ISO-Code) |
↳ absent | boolean | Ob der Teilnehmer abwesend war |
↳ hosts | array | Liste der Gastgeber |
↳ id | number | Benutzer-ID des Gastgebers |
↳ name | string | Anzeigename des Gastgebers |
↳ email | string | Tatsächliche E-Mail-Adresse des Gastgebers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ username | string | Cal.com-Benutzername des Gastgebers |
↳ timeZone | string | Zeitzone des Gastgebers (IANA-Format) |
↳ id | number | Numerische Buchungs-ID |
↳ title | string | Titel der Buchung |
↳ status | string | Buchungsstatus (z. B. akzeptiert, ausstehend, storniert) |
↳ reschedulingReason | string | Grund für die Verschiebung, falls verschoben |
↳ rescheduledFromUid | string | Ursprüngliche Buchungs-UID, falls diese Buchung verschoben wurde |
↳ rescheduledByEmail | string | E-Mail der Person, die die Buchung verschoben hat |
↳ duration | number | Dauer in Minuten |
↳ eventTypeId | number | Ereignistyp-ID |
↳ meetingUrl | string | URL zum Beitreten des Meetings |
↳ location | string | Ort der Buchung |
↳ guests | array | E-Mail-Adressen der Gäste |
↳ metadata | json | Benutzerdefinierte Metadaten, die an die Buchung angehängt sind (dynamische Schlüssel-Wert-Paare) |
↳ icsUid | string | ICS-Kalender-UID |
↳ createdAt | string | Zeitpunkt der Erstellung der Buchung |
↳ uid | string | Eindeutige Kennung für die neue Buchung |
↳ start | string | Neue Startzeit im ISO 8601-Format |
↳ end | string | Neue Endzeit im ISO 8601-Format |
Eine ausstehende Buchung bestätigen, die eine Bestätigung erfordert
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
bookingUid | string | Ja | Eindeutige Kennung (UID) der zu bestätigenden Buchung |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Details der bestätigten Buchung |
↳ eventType | object | Details des Ereignistyps |
↳ id | number | Ereignistyp-ID |
↳ slug | string | Ereignistyp-Slug |
↳ attendees | array | Liste der Teilnehmer |
↳ name | string | Name des Teilnehmers |
↳ email | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ timeZone | string | Zeitzone des Teilnehmers (IANA-Format) |
↳ phoneNumber | string | Telefonnummer des Teilnehmers |
↳ language | string | Sprachpräferenz des Teilnehmers (ISO-Code) |
↳ absent | boolean | Ob der Teilnehmer abwesend war |
↳ hosts | array | Liste der Gastgeber |
↳ id | number | Benutzer-ID des Gastgebers |
↳ name | string | Anzeigename des Gastgebers |
↳ email | string | Tatsächliche E-Mail-Adresse des Gastgebers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ username | string | Cal.com-Benutzername des Gastgebers |
↳ timeZone | string | Zeitzone des Gastgebers (IANA-Format) |
↳ id | number | Numerische Buchungs-ID |
↳ uid | string | Eindeutige Kennung für die Buchung |
↳ title | string | Titel der Buchung |
↳ start | string | Startzeit im ISO-8601-Format |
↳ end | string | Endzeit im ISO-8601-Format |
↳ duration | number | Dauer in Minuten |
↳ eventTypeId | number | Ereignistyp-ID |
↳ meetingUrl | string | URL zum Beitreten des Meetings |
↳ location | string | Ort der Buchung |
↳ guests | array | E-Mail-Adressen der Gäste |
↳ metadata | json | Benutzerdefinierte Metadaten, die der Buchung angehängt sind (dynamische Schlüssel-Wert-Paare) |
↳ icsUid | string | ICS-Kalender-UID |
↳ createdAt | string | Zeitpunkt der Erstellung der Buchung |
↳ status | string | Buchungsstatus (sollte akzeptiert/bestätigt sein) |
Eine ausstehende Buchungsanfrage ablehnen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
bookingUid | string | Ja | Eindeutige Kennung (UID) der abzulehnenden Buchung |
reason | string | Nein | Grund für die Ablehnung der Buchung |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Details der abgelehnten Buchung |
↳ eventType | object | Details des Ereignistyps |
↳ id | number | Ereignistyp-ID |
↳ slug | string | Ereignistyp-Slug |
↳ attendees | array | Liste der Teilnehmer |
↳ name | string | Name des Teilnehmers |
↳ email | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ timeZone | string | Zeitzone des Teilnehmers (IANA-Format) |
↳ phoneNumber | string | Telefonnummer des Teilnehmers |
↳ language | string | Sprachpräferenz des Teilnehmers (ISO-Code) |
↳ absent | boolean | Ob der Teilnehmer abwesend war |
↳ hosts | array | Liste der Gastgeber |
↳ id | number | Benutzer-ID des Gastgebers |
↳ name | string | Anzeigename des Gastgebers |
↳ email | string | Tatsächliche E-Mail-Adresse des Gastgebers |
↳ displayEmail | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
↳ username | string | Cal.com-Benutzername des Gastgebers |
↳ timeZone | string | Zeitzone des Gastgebers (IANA-Format) |
↳ id | number | Numerische Buchungs-ID |
↳ uid | string | Eindeutige Kennung für die Buchung |
↳ title | string | Titel der Buchung |
↳ cancellationReason | string | Grund für die Stornierung, falls storniert |
↳ start | string | Startzeit im ISO-8601-Format |
↳ end | string | Endzeit im ISO-8601-Format |
↳ duration | number | Dauer in Minuten |
↳ eventTypeId | number | Ereignistyp-ID |
↳ location | string | Ort der Buchung |
↳ metadata | json | Benutzerdefinierte Metadaten, die der Buchung angehängt sind (dynamische Schlüssel-Wert-Paare) |
↳ createdAt | string | Zeitpunkt der Erstellung der Buchung |
↳ status | string | Buchungsstatus (sollte storniert/abgelehnt sein) |
Einen neuen Ereignistyp in Cal.com erstellen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
title | string | Ja | Titel des Ereignistyps |
slug | string | Ja | Eindeutiger Slug für die Ereignistyp-URL |
lengthInMinutes | number | Ja | Dauer des Ereignisses in Minuten |
description | string | Nein | Beschreibung des Ereignistyps |
slotInterval | number | Nein | Intervall zwischen verfügbaren Buchungsslots in Minuten |
minimumBookingNotice | number | Nein | Erforderliche Mindestvorlaufzeit vor der Buchung in Minuten |
beforeEventBuffer | number | Nein | Pufferzeit vor dem Ereignis in Minuten |
afterEventBuffer | number | Nein | Pufferzeit nach dem Ereignis in Minuten |
scheduleId | number | Nein | ID des Zeitplans für die Verfügbarkeit |
disableGuests | boolean | Nein | Ob das Hinzufügen von Gästen zu Buchungen deaktiviert ist |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Details des erstellten Ereignistyps |
↳ id | number | Ereignistyp-ID |
↳ title | string | Ereignistyp-Titel |
↳ slug | string | Ereignistyp-Slug |
↳ description | string | Ereignistyp-Beschreibung |
↳ lengthInMinutes | number | Dauer in Minuten |
↳ slotInterval | number | Slot-Intervall in Minuten |
↳ minimumBookingNotice | number | Mindestvorlaufzeit für Buchung in Minuten |
↳ beforeEventBuffer | number | Puffer vor Ereignis in Minuten |
↳ afterEventBuffer | number | Puffer nach Ereignis in Minuten |
↳ scheduleId | number | Zeitplan-ID |
↳ disableGuests | boolean | Ob Gäste deaktiviert sind |
↳ createdAt | string | ISO-Zeitstempel der Erstellung |
↳ updatedAt | string | ISO-Zeitstempel der letzten Aktualisierung |
Detaillierte Informationen über einen bestimmten Ereignistyp abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
eventTypeId | number | Ja | Ereignistyp-ID zum Abrufen |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Details zum Ereignistyp |
↳ id | number | Ereignistyp-ID |
↳ title | string | Titel des Ereignistyps |
↳ slug | string | Slug des Ereignistyps |
↳ description | string | Beschreibung des Ereignistyps |
↳ lengthInMinutes | number | Dauer in Minuten |
↳ slotInterval | number | Zeitfensterintervall in Minuten |
↳ minimumBookingNotice | number | Mindestvorlaufzeit für Buchungen in Minuten |
↳ beforeEventBuffer | number | Puffer vor dem Ereignis in Minuten |
↳ afterEventBuffer | number | Puffer nach dem Ereignis in Minuten |
↳ scheduleId | number | Zeitplan-ID |
↳ disableGuests | boolean | Ob Gäste deaktiviert sind |
↳ createdAt | string | ISO-Zeitstempel der Erstellung |
↳ updatedAt | string | ISO-Zeitstempel der letzten Aktualisierung |
Eine Liste aller Ereignistypen abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
sortCreatedAt | string | Nein | Sortierung nach Erstellungsdatum: "asc" oder "desc" |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | array | Array von Ereignistypen |
↳ id | number | Ereignistyp-ID |
↳ title | string | Ereignistyp-Titel |
↳ slug | string | Ereignistyp-Slug |
↳ description | string | Ereignistyp-Beschreibung |
↳ lengthInMinutes | number | Dauer in Minuten |
↳ slotInterval | number | Zeitfensterintervall in Minuten |
↳ minimumBookingNotice | number | Mindestvorlaufzeit für Buchungen in Minuten |
↳ beforeEventBuffer | number | Pufferzeit vor dem Ereignis in Minuten |
↳ afterEventBuffer | number | Pufferzeit nach dem Ereignis in Minuten |
↳ scheduleId | number | Zeitplan-ID |
↳ disableGuests | boolean | Ob Gäste deaktiviert sind |
↳ createdAt | string | ISO-Zeitstempel der Erstellung |
↳ updatedAt | string | ISO-Zeitstempel der letzten Aktualisierung |
Einen bestehenden Ereignistyp in Cal.com aktualisieren
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
eventTypeId | number | Ja | Zu aktualisierende Ereignistyp-ID (z. B. 12345) |
title | string | Nein | Titel des Ereignistyps |
slug | string | Nein | Eindeutiger Slug für die Ereignistyp-URL |
lengthInMinutes | number | Nein | Dauer des Ereignisses in Minuten |
description | string | Nein | Beschreibung des Ereignistyps |
slotInterval | number | Nein | Intervall zwischen verfügbaren Buchungszeitfenstern in Minuten |
minimumBookingNotice | number | Nein | Erforderliche Mindestvorlaufzeit vor der Buchung in Minuten |
beforeEventBuffer | number | Nein | Pufferzeit vor dem Ereignis in Minuten |
afterEventBuffer | number | Nein | Pufferzeit nach dem Ereignis in Minuten |
scheduleId | number | Nein | ID des Zeitplans für die Verfügbarkeit |
disableGuests | boolean | Nein | Ob das Hinzufügen von Gästen zu Buchungen deaktiviert werden soll |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Aktualisierte Details des Ereignistyps |
↳ id | number | Ereignistyp-ID |
↳ title | string | Titel des Ereignistyps |
↳ slug | string | Slug des Ereignistyps |
↳ description | string | Beschreibung des Ereignistyps |
↳ lengthInMinutes | number | Dauer in Minuten |
↳ slotInterval | number | Zeitfensterintervall in Minuten |
↳ minimumBookingNotice | number | Mindestvorlaufzeit für Buchungen in Minuten |
↳ beforeEventBuffer | number | Puffer vor dem Ereignis in Minuten |
↳ afterEventBuffer | number | Puffer nach dem Ereignis in Minuten |
↳ scheduleId | number | Zeitplan-ID |
↳ disableGuests | boolean | Ob Gäste deaktiviert sind |
↳ createdAt | string | ISO-Zeitstempel der Erstellung |
↳ updatedAt | string | ISO-Zeitstempel der letzten Aktualisierung |
Einen Ereignistyp aus Cal.com löschen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
eventTypeId | number | Ja | Zu löschende Ereignistyp-ID |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Details des gelöschten Ereignistyps |
↳ id | number | Ereignistyp-ID |
↳ lengthInMinutes | number | Dauer in Minuten |
↳ title | string | Titel des Ereignistyps |
↳ slug | string | Slug des Ereignistyps |
Einen neuen Verfügbarkeitsplan in Cal.com erstellen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
name | string | Ja | Name des Plans |
timeZone | string | Ja | Zeitzone für den Plan (z. B. America/New_York) |
isDefault | boolean | Ja | Ob dieser Plan als Standard festgelegt werden soll |
availability | array | Nein | Verfügbarkeitsintervalle für den Plan |
items | object | Nein | Verfügbarkeitsintervall |
properties | array | Nein | Wochentage (Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag) |
days | array | Nein | Wochentage (Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag) |
startTime | string | Nein | Startzeit im Format HH:MM |
endTime | string | Nein | Endzeit im Format HH:MM |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Erstellte Plandaten |
↳ id | number | Plan-ID |
↳ ownerId | number | Benutzer-ID des Eigentümers |
↳ name | string | Planname |
↳ timeZone | string | Zeitzone (z. B. America/New_York) |
↳ isDefault | boolean | Ob dies der Standardplan ist |
↳ availability | array | Verfügbarkeitsfenster |
↳ days | array | Wochentage (Montag, Dienstag usw.) |
↳ startTime | string | Startzeit im Format HH:MM |
↳ endTime | string | Endzeit im Format HH:MM |
↳ overrides | array | Datumsspezifische Verfügbarkeitsüberschreibungen |
↳ date | string | Datum im Format JJJJ-MM-TT |
↳ startTime | string | Startzeit im Format HH:MM |
↳ endTime | string | Endzeit im Format HH:MM |
Einen bestimmten Zeitplan anhand der ID von Cal.com abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
scheduleId | string | Ja | ID des abzurufenden Zeitplans |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Zeitplandaten |
↳ id | number | Zeitplan-ID |
↳ ownerId | number | Benutzer-ID des Eigentümers |
↳ name | string | Zeitplanname |
↳ timeZone | string | Zeitzone (z. B. America/New_York) |
↳ isDefault | boolean | Ob dies der Standardzeitplan ist |
↳ availability | array | Verfügbarkeitsfenster |
↳ days | array | Wochentage (Montag, Dienstag usw.) |
↳ startTime | string | Startzeit im Format HH:MM |
↳ endTime | string | Endzeit im Format HH:MM |
↳ overrides | array | Datumsspezifische Verfügbarkeitsüberschreibungen |
↳ date | string | Datum im Format JJJJ-MM-TT |
↳ startTime | string | Startzeit im Format HH:MM |
↳ endTime | string | Endzeit im Format HH:MM |
Alle Verfügbarkeitszeitpläne von Cal.com auflisten
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | array | Array von Zeitplanobjekten |
↳ id | number | Zeitplan-ID |
↳ ownerId | number | Benutzer-ID des Eigentümers |
↳ name | string | Zeitplanname |
↳ timeZone | string | Zeitzone (z. B. America/New_York) |
↳ isDefault | boolean | Ob dies der Standardzeitplan ist |
↳ availability | array | Verfügbarkeitsfenster |
↳ days | array | Wochentage (Montag, Dienstag usw.) |
↳ startTime | string | Startzeit im Format HH:MM |
↳ endTime | string | Endzeit im Format HH:MM |
↳ overrides | array | Datumsspezifische Verfügbarkeitsüberschreibungen |
↳ date | string | Datum im Format JJJJ-MM-TT |
↳ startTime | string | Startzeit im Format HH:MM |
↳ endTime | string | Endzeit im Format HH:MM |
Einen bestehenden Zeitplan in Cal.com aktualisieren
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
scheduleId | string | Ja | ID des zu aktualisierenden Zeitplans |
name | string | Nein | Neuer Name für den Zeitplan |
timeZone | string | Nein | Neue Zeitzone für den Zeitplan (z. B. America/New_York) |
isDefault | boolean | Nein | Ob dieser Zeitplan als Standard festgelegt werden soll |
availability | array | Nein | Neue Verfügbarkeitsintervalle für den Zeitplan |
items | object | Nein | Verfügbarkeitsintervall |
properties | array | Nein | Wochentage (Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag) |
days | array | Nein | Wochentage (Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag) |
startTime | string | Nein | Startzeit im Format HH:MM |
endTime | string | Nein | Endzeit im Format HH:MM |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Aktualisierte Zeitplandaten |
↳ id | number | Zeitplan-ID |
↳ ownerId | number | Benutzer-ID des Eigentümers |
↳ name | string | Zeitplanname |
↳ timeZone | string | Zeitzone (z. B. America/New_York) |
↳ isDefault | boolean | Ob dies der Standardzeitplan ist |
↳ availability | array | Verfügbarkeitsfenster |
↳ days | array | Wochentage (Montag, Dienstag usw.) |
↳ startTime | string | Startzeit im Format HH:MM |
↳ endTime | string | Endzeit im Format HH:MM |
↳ overrides | array | Datumsspezifische Verfügbarkeitsüberschreibungen |
↳ date | string | Datum im Format JJJJ-MM-TT |
↳ startTime | string | Startzeit im Format HH:MM |
↳ endTime | string | Endzeit im Format HH:MM |
Einen Zeitplan aus Cal.com löschen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
scheduleId | string | Ja | ID des zu löschenden Zeitplans |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus (Erfolg oder Fehler) |
Den Standard-Verfügbarkeitszeitplan aus Cal.com abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | object | Standard-Zeitplandaten |
↳ id | number | Zeitplan-ID |
↳ ownerId | number | Benutzer-ID des Eigentümers |
↳ name | string | Zeitplanname |
↳ timeZone | string | Zeitzone (z. B. America/New_York) |
↳ isDefault | boolean | Ob dies der Standardzeitplan ist |
↳ availability | array | Verfügbarkeitsfenster |
↳ days | array | Wochentage (Montag, Dienstag usw.) |
↳ startTime | string | Startzeit im Format HH:MM |
↳ endTime | string | Endzeit im Format HH:MM |
↳ overrides | array | Datumsspezifische Verfügbarkeitsüberschreibungen |
↳ date | string | Datum im Format JJJJ-MM-TT |
↳ startTime | string | Startzeit im Format HH:MM |
↳ endTime | string | Endzeit im Format HH:MM |
Verfügbare Buchungsslots für einen Cal.com-Ereignistyp innerhalb eines Zeitraums abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
start | string | Ja | Beginn des Zeitraums im UTC ISO 8601-Format (z. B. 2024-01-15T00:00:00Z) |
end | string | Ja | Ende des Zeitraums im UTC ISO 8601-Format (z. B. 2024-01-22T00:00:00Z) |
eventTypeId | number | Nein | Ereignistyp-ID für direkte Suche |
eventTypeSlug | string | Nein | Ereignistyp-Slug (erfordert, dass der Benutzername gesetzt ist) |
username | string | Nein | Benutzername für persönliche Ereignistypen (erforderlich bei Verwendung von eventTypeSlug) |
timeZone | string | Nein | Zeitzone für zurückgegebene Slots (Standard ist UTC) |
duration | number | Nein | Slot-Länge in Minuten |
| Parameter | Typ | Beschreibung |
|---|
status | string | Antwortstatus |
data | json | Verfügbare Zeitslots gruppiert nach Datum (Schlüssel im Format JJJJ-MM-TT). Jedes Datum ist einem Array von Slot-Objekten mit Startzeit, optionaler Endzeit und Informationen zu Sitzplatz-Events zugeordnet. |
