Skip to content
Docs

Calendar and agenda

Connecting Google Calendar, choosing which calendars block time and picking the one that receives new events are done in your dashboard settings, not through the API. The endpoints here read the result. Both need an API key.

The agenda combines your bookings, group sessions and, when connected, busy time and events from Google Calendar for a window of up to 62 days.

GET /calendar

The connected Google calendar status. Auth: API key.

Response 200

Body

FieldTypeRequiredDefault / limits
connectedbooleanyes-
provider"google" | nullyes-
accountEmailstring | nullyes-
status"active" | "needs_reconnect" | nullyes-
conflictCalendarIdsstring[]yes-
targetCalendarIdstring | nullyes-

Errors: unauthorized

curl -X GET "https://devalender.com/api/calendar" \
  -H "Authorization: Bearer dvl_..."

GET /me/agenda

Bookings, sessions and optional Google busy time in a window. Auth: API key.

Query parameters

FieldTypeRequiredDefault / limits
fromstring (date-time)yes-
tostring (date-time)yes-
busy"0" | "1"no-
events"0" | "1"no-

Response 200

Body

FieldTypeRequiredDefault / limits
bookingsobject[]yes-
bookings[].idstring (uuid)yes-
bookings[].eventTypeIdstring (uuid)yes-
bookings[].color"brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | nullno-
bookings[].titlestringyes-
bookings[].inviteeNamestringyes-
bookings[].startAtstring (date-time)yes-
bookings[].endAtstring (date-time)yes-
sessionsobject[]yes-
sessions[].idstring (uuid)yes-
sessions[].eventTypeIdstring (uuid)yes-
sessions[].color"brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | nullno-
sessions[].titlestringyes-
sessions[].startAtstring (date-time)yes-
sessions[].endAtstring (date-time)yes-
sessions[].capacityintegeryes-9007199254740991–9007199254740991
sessions[].seatsTakenintegeryes-9007199254740991–9007199254740991
busyobject[] | nullyes-
busy.startAtstring (date-time)yes-
busy.endAtstring (date-time)yes-
googleEventsobject[] | nullyes-
googleEvents.idstringyes-
googleEvents.calendarIdstringyes-
googleEvents.titlestring | nullyes-
googleEvents.startAtstring (date-time)yes-
googleEvents.endAtstring (date-time)yes-
googleEvents.allDaybooleanyes-
googleEvents.locationstring | nullyes-
googleEvents.descriptionExcerptstring | nullyes-
googleEvents.htmlLinkstring | nullyes-

Errors: invalid_request, unauthorized

curl -X GET "https://devalender.com/api/me/agenda?from=2030-01-07T10%3A00%3A00Z&to=2030-01-07T10%3A00%3A00Z" \
  -H "Authorization: Bearer dvl_..."