پرش به مستندات
API

ساخت رویداد

رویدادی را در تقویم می‌گذارد، همان کاری که «رویداد جدید» در برنامه می‌کند، و شرکت‌کنندگان را دعوت می‌کند.

POST/calendar/events

فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.

POST /calendar/events

رویدادی را در تقویم می‌گذارد، همان کاری که «رویداد جدید» در برنامه می‌کند، و شرکت‌کنندگان را دعوت می‌کند.

نمونه

به calendar:write نیاز دارد، و وقتی رویداد شرکت‌کننده دارد به emails:send هم، چون هر کدام از آن‌ها دعوتی با ایمیل از from می‌گیرد.

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]"}'
پاسخ
{  "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 }.

مرجع