API
ساخت رویداد
رویدادی را در تقویم میگذارد، همان کاری که «رویداد جدید» در برنامه میکند، و شرکتکنندگان را دعوت میکند.
POST/calendar/events
فراخوانی واقعی را روی فضای کاری شما اجرا میکند.
POST /calendar/events
رویدادی را در تقویم میگذارد، همان کاری که «رویداد جدید» در برنامه میکند، و شرکتکنندگان را دعوت میکند.
نمونه
به calendar:write نیاز دارد، و وقتی رویداد شرکتکننده دارد به emails:send هم، چون هر کدام از آنها دعوتی با ایمیل از from میگیرد.
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]"}'{ "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 باید نشانیای باشد که کلید اجازهٔ فرستادن از آن را دارد، وگرنه درخواست 403 from_address_forbidden است. رویدادی که شرکتکننده دارد و from ندارد 422 invalid_parameter است، مگر اینکه sendInvites برابر false باشد.
recurrence یک RRULE مانند FREQ=WEEKLY;BYDAY=MO میگیرد، و reminders تا پنج { minutesBefore }.