Synology has not yet published any documentation about the Calendar API v5. There is also little information available on forums. I have found that the network traffic of the Synology Calendar App gives me the information to use the API myself. In this article I explain how to fill your calendar from Node-red using version 5 of the API.<\/p>\n\n\n\n
An important change is the format of certain data in the request. Text fields must be surrounded by double-quotes in the request. So Time fields are changed from text to unix timestamps numbers. So And empty strings and empty arrays have to be send as ‘””‘, respectively ‘[]’:<\/p>\n\n\n\n To add an event you’ll need the following steps: Retrieve a list of calendars, use:<\/p>\n\n\n\n Create an all day event with dtstart as date object, to return a timestamp like 1735689600:<\/p>\n\n\n\n Synology has not yet published any documentation about the Calendar API v5. There is also little information available on forums. I have found that the network traffic of the Synology Calendar App gives me the information to use the API myself. In this article I explain how to fill your calendar from Node-red using version […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[29,14],"class_list":["post-414","post","type-post","status-publish","format-standard","hentry","category-software","tag-node-red","tag-synology"],"_links":{"self":[{"href":"https:\/\/www.bolukan.nl\/index.php?rest_route=\/wp\/v2\/posts\/414","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bolukan.nl\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.bolukan.nl\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.bolukan.nl\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bolukan.nl\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=414"}],"version-history":[{"count":4,"href":"https:\/\/www.bolukan.nl\/index.php?rest_route=\/wp\/v2\/posts\/414\/revisions"}],"predecessor-version":[{"id":419,"href":"https:\/\/www.bolukan.nl\/index.php?rest_route=\/wp\/v2\/posts\/414\/revisions\/419"}],"wp:attachment":[{"href":"https:\/\/www.bolukan.nl\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=414"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.bolukan.nl\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=414"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.bolukan.nl\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=414"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}} summary: summary,<\/code>
has to become summary: `\"${summary}\"`<\/code>,<\/p>\n\n\n\n
dtstart: \"2025-01-01T00:00:00\",<\/code>
has to become dtstart: 1735689600,<\/code>
and in a response the API also sends a string, in this example a date for an all day event: dtstart_string: \"20250101\"<\/code><\/p>\n\n\n\n \u00a0 color: `\"\"`,<\/code> participant: \"[]\",<\/code><\/code><\/pre>\n\n\n\n
Authenticate and get the token\/security identifier:<\/p>\n\n\n\nhttps:\/\/mysynology\/webapi\/auth.cgi?api=SYNO.API.Auth&version=7&method=login&account=myaccount&passwd=mypassword&session=mysessionname&format=sid&enable_syno_token=yes<\/code><\/code><\/pre>\n\n\n\nflow.set(\"sid\", msg.payload.data.sid);\nflow.set(\"synotoken\", msg.payload.data.synotoken);\nflow.set(\"device_id\", msg.payload.data.device_id);<\/code><\/pre>\n\n\n\nmsg.payload = {\n api: \"SYNO.Cal.Cal\",\n version: 5,\n method: \"list\",\n cal_type: `\"event\"`\n};<\/code><\/pre>\n\n\n\nvar event = {\n api: \"SYNO.Cal.Event\",\n method: \"create\",\n version: 5,\n cal_id: `\"${cal_id}\"`,\n original_cal_id: `\"${cal_id}\"`,\n summary: `\"${summary}\"`,\n is_all_day: true,\n tz_id: `\"\"`,\n dtstart: Math.floor(dtstart.getTime()\/1000),\n dtend: Math.floor(dtend.getTime()\/1000),\n is_repeat_evt: false,\n color: `\"\"`,\n description: `\"\"`,\n participant: \"[]\",\n notify_setting: \"[]\",\n};<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"