List calendar subscription links

GET/api/v1/mailbox/calendar-subscriptions
Requires amailbox token— it acts as one mailbox holder, not as the organization.

Private links that let another calendar app (Google, Outlook, Apple) show this calendar, read-only.

Errors

Status When
401 No token, or the session expired or was signed out. Sign in again with POST /mailbox-auth/login.
403 The account has a temporary password: until POST /security/password succeeds, every other call answers this with error_code: password_change_required.

Request

GET/api/v1/mailbox/calendar-subscriptions
curl -X GET 'https://courier.mailyte.com/api/v1/mailbox/calendar-subscriptions' \
  -H 'Authorization: Bearer MAILBOX_TOKEN'

Response

Successful Response

  • dataarray<object>
    • tokenstring
    • calendar_uristring
    • labelstring or null
    • urlstring or null
    • webcal_urlstring or null
    • created_atstring or null
    • last_accessed_atstring or null
200application/json
{
  "type": "success",
  "msg": "Subscriptions retrieved successfully",
  "data": [
    {
      "token": "s3cr3t-token",
      "calendar_uri": "default",
      "label": "My phone",
      "url": "https://mail.mailyte.com/ics/s3cr3t-token.ics",
      "webcal_url": "webcal://mail.mailyte.com/ics/s3cr3t-token.ics",
      "created_at": "2026-10-01T10:00:00+00:00",
      "last_accessed_at": "2026-10-11T07:00:00+00:00"
    }
  ]
}

Returned inside the standard envelope.

Errors

StatusWhen
401No token, or the session expired or was signed out. Sign in again with `POST /mailbox-auth/login`.
403The account has a temporary password: until `POST /security/password` succeeds, every other call answers this with `error_code: password_change_required`.

Every status, with what causes it and what to do, is on the error reference.