agents

Connect calendar to agent

Links a calendar (Google/Outlook/Apple) to the agent so it can check availability and auto-book appointments during calls. Specify work hours per day (HHMM format), timezone, default duration, buffer minutes. The calendar must already belong to the user.

post/agents/{id}/calendars

Request

  • Base URL: https://be.skipcalls.com (the document declares no server; this is the origin it was published from)
  • URL: https://be.skipcalls.com/agents/{id}/calendars
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

calendarIdstring required
descriptionstring
defaultDurationnumber required
bufferMinutesnumber required
timezonestring
workHoursByDayobject required

Work hours by day in HHMM format (e.g., {"MONDAY": [900, 1730]})

workDaysstring[] required
isActiveboolean required

Allow event creation on this calendar

showEventNamesboolean

Share event names with callers instead of just busy/free times

allowDoubleBookingboolean

Allow booking overlapping appointments on the same time slot

Example request

{
  "workHoursByDay": {
    "MONDAY": [
      900,
      1730
    ],
    "TUESDAY": [
      900,
      1730
    ],
    "WEDNESDAY": [
      900,
      1730
    ],
    "THURSDAY": [
      900,
      1730
    ],
    "FRIDAY": [
      900,
      1730
    ]
  }
}

Changes

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