POST
/office/api/createBreak?token=IHR_TOKEN&id=7473&from=01.06.2026 18:00&until=02.06.2026 19:00
Diese Schnittstelle gehört zur Geschützten API und benötigt einen
API-Schlüssel. Den Token erstellen Sie in Ihrem Kalender unter den globalen
Einstellungen als API Zugang – siehe
API-Schnittstellen.
Blockiert einen Mitarbeiter für einen bestimmten Zeitraum, indem eine Pause (Break) in der Belbo-Buchungs-API angelegt wird. Während dieser Zeit ist der Mitarbeiter nicht für Kundentermine verfügbar.
Endpunkt
| Methode | URL |
|---|---|
POST |
https://<IhrGeschäft>.belbo.com/office/api/createBreak |
Query-Parameter
| Name | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
token |
string |
Pflicht | Authentifizierungs-Token für den API-Zugriff. |
id |
string |
Pflicht | Die eindeutige ID des Mitarbeiters, der blockiert werden soll. |
from |
string |
Pflicht | Beginn der Pause im Format DD.MM.YYYY HH:mm. |
until |
string |
Pflicht | Ende der Pause im Format DD.MM.YYYY HH:mm. |
Antwort
Bei Erfolg gibt der Endpunkt den HTTP-Statuscode 200 OK zurück und liefert die ID der neu erstellten Pause.
Beispiel-Antwort
{
"id": 192145980
}
| Feld | Typ | Beschreibung |
|---|---|---|
id |
integer |
Die eindeutige ID der erstellten Pause. |
Parameter
| Name | Übergabe |
|---|---|
token |
URL-Parameter |
BeispielIHR_TOKEN
|
|
id |
URL-Parameter |
Beispiel7473
|
|
from |
URL-Parameter |
Beispiel01.06.2026 18:00
|
|
until |
URL-Parameter |
Beispiel02.06.2026 19:00
|
|
Struktur zuletzt mit der Postman-Collection abgeglichen: 09.09.2026