Calendars
Each calendar account connected to Morgen can have multiple calendars.
Each calendar contains a list of events. Calendars contain fields
that describe the calendar itself, such as its name, color, and time zone.
The id
field is the unique identifier of the calendar and is used to
reference the calendar in other API methods (e.g. to retrieve events).
List calendars
Returns a list of calendars for an authenticated account.
curl --request GET \
--url https://sync.morgen.so/v1/calendars/list?accountId=<ACCOUNT_ID> \
--header 'accept: application/json' \
--header 'Authorization: Bearer <JWT>'
Parameter | Type | Default | Required | Description |
---|---|---|---|---|
accountId | Query | - | Yes | The Account ID to retrieve calendars from. |
Morgen data model for calendars is modeled after the JMAP specification (opens in a new tab), with some differences.
Here is an example response:
{
"data": {
"calendars": [
{
"@type": "Calendar",
"id": "WyI2NDBhNjJjOWFhNWI3ZTA2Y2Y0MjQw...",
"name": "Calendar",
"color": "#88baf8",
"myRights": {
"mayReadFreeBusy": true,
"mayReadItems": true,
"mayWriteAll": true,
"mayWriteOwn": true,
"mayUpdatePrivate": true,
"mayRSVP": true,
"mayAdmin": true,
"mayDelete": true
},
"accountId": "640a62c9aa5b7e06cf4240f8",
"integrationId": "o365",
"sortOrder": 0
},
...
]
}
}