Skip to content

List calendar connections

GET
/api/workspaces/{workspaceId}/calendar-connections

Retrieve all calendar connections for a workspace.

workspaceId
required
string format: uuid

The workspace to list calendar connections for.

All calendar connections for the workspace.

List of calendar connections for a workspace.

object
items
required
Array<object>

A calendar connection links an external calendar provider (Google Calendar, Microsoft Outlook) to a workspace via OAuth.

object
id
required

Unique identifier for the calendar connection.

string format: uuid
Example
cal_11223344-5566-7788-99aa-bbccddeeff00
workspaceId
required

The workspace this connection belongs to.

string format: uuid
Example
a1b2c3d4-e5f6-7890-abcd-ef1234567890
provider
required

Calendar provider: google or microsoft.

string
Example
google
displayName
required

Human-readable name for the connection.

string
Example
Sales Team Calendar
calendarId

Calendar identifier from the provider.

string | null
Example
sales@nordic-parts.dk
enabled
required

Whether the connection is active.

boolean
Example
true
bookingConfig

Scheduling configuration.

object
workingHours

Per-day start and end times.

object
key
additional properties
object
start
string
Example
09:00
end
string
Example
17:00
bufferMinutes

Minimum buffer between consecutive bookings.

integer
Example
15
timezone

IANA timezone identifier.

string
Example
Europe/Copenhagen
blockedDates

Dates in YYYY-MM-DD format when no bookings are accepted.

Array<string>
Example
[
"2026-12-24",
"2026-12-25",
"2026-12-31"
]
createdAt
required
string format: date-time
Example
2026-03-10T08:00:00.000Z
updatedAt
required
string format: date-time
Example
2026-03-12T14:20:00.000Z
total
required
integer
Example
1