Get calendar connection

GET

/api/calendar-connections/{connectionId}

Production

Retrieve a single calendar connection by its identifier.

Authorizations

bearerAuth

Parameters

Path Parameters

connectionId

required

string format: uuid

The unique identifier of the calendar connection.

Responses

200

The calendar connection was found and returned.

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

object

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

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

404

No calendar connection exists with the given ID.

Standard error response returned by all endpoints on failure.

object

error

required

A human-readable error message describing what went wrong.

string

Example

Conversation not found