Calendars

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>'
ParameterTypeDefaultRequiredDescription
accountIdQuery-YesThe 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
      },
     ...
    ]
  }
}