Zur Dokumentation springen
API

Einen Termin erstellen

Trägt einen Termin in den Kalender ein, wie „Neuer Termin“ in der App, und lädt die Teilnehmer ein.

POST/calendar/events

Führt den echten Aufruf in Ihrem Workspace aus.

POST /calendar/events

Trägt einen Termin in den Kalender ein, wie „Neuer Termin“ in der App, und lädt die Teilnehmer ein.

Beispiel

Erfordert calendar:write und auch emails:send, wenn der Termin Teilnehmer hat, weil jeder von ihnen eine Einladung per E-Mail von from erhält.

curl
curl -X POST "$OE/calendar/events" -H "$AUTH" -H 'content-type: application/json' -d '{  "summary": "Planning",  "start": "2026-10-12T09:00:00Z",  "end": "2026-10-12T09:30:00Z",  "timezone": "Europe/London",  "recurrence": "FREQ=WEEKLY;BYDAY=MO",  "attendees": [{ "email": "[email protected]", "name": "Ada" }],  "reminders": [{ "minutesBefore": 10 }],  "from": "[email protected]"}'
Antwort
{  "object": "calendar_event",  "id": "cal_3f9a1c7e5b2d48a06c1e9f4b",  "uid": "5d2c8e1a-7b3f-4c9d-a6e2-1f8b0c4d7e93@openemail",  "sequence": 0,  "summary": "Planning",  "description": null,  "location": "Room 2",  "url": null,  "start": "2026-10-12T09:00:00.000Z",  "end": "2026-10-12T09:30:00.000Z",  "allDay": false,  "timezone": "Europe/London",  "recurrence": "FREQ=WEEKLY;BYDAY=MO",  "exdates": [],  "status": "CONFIRMED",  "transparency": "OPAQUE",  "visibility": "PUBLIC",  "organizer": { "email": "[email protected]", "name": null },  "isOrganizer": true,  "source": "local",  "messageId": null,  "threadId": null,  "alarms": [{ "minutesBefore": 10, "action": "DISPLAY" }],  "attendees": [    {      "object": "calendar_attendee",      "email": "[email protected]",      "name": "Ada",      "partstat": "NEEDS-ACTION",      "role": "REQ-PARTICIPANT",      "rsvp": true,      "cutype": null,      "respondedAt": null    }  ],  "createdAt": "2026-10-02T14:03:11.000Z",  "updatedAt": "2026-10-02T14:03:11.000Z"}

from muss eine Adresse sein, von der der Schlüssel senden darf, sonst ergibt der Aufruf 403 from_address_forbidden. Ein Termin mit Teilnehmern und ohne from ergibt 422 invalid_parameter, außer sendInvites ist false.

recurrence nimmt eine RRULE wie FREQ=WEEKLY;BYDAY=MO, und reminders bis zu fünf { minutesBefore }.

Referenz