Calendars

Retrieve calendar

Retrieve a specific calendar by its ID. The calendar is returned with all its properties including name, description, color, timezone, and order.

get/v1/calendars/{id}

Request

  • Base URL: https://api.forwardemail.net
  • URL: https://api.forwardemail.net/v1/calendars/{id}
  • Auth: HTTP basic

Path parameters

idstring required

Calendar ID

Response

Calendar retrieved successfully

idstring required

Calendar ID (calendarId from CalDAV)

namestring required

Calendar name

descriptionstring required

Calendar description

colorstring required

Calendar color (hex format)

timezonestring required

Calendar timezone

orderinteger required

Calendar display order

created_atstring date-time required
updated_atstring date-time required
object'calendar' required

Example response

{
  "id": "calendar123",
  "name": "Personal Calendar",
  "description": "My personal calendar",
  "color": "#ff0000",
  "timezone": "America/New_York",
  "order": 0,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z",
  "object": "calendar"
}

Changes

No recorded changes to this operation across all 1 revision of this API.