Connect calendar to agent

POST

/agents/{id}/calendars

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.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location '/agents//calendars' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "calendarId": "string",
    "description": "string",
    "defaultDuration": 30,
    "bufferMinutes": 15,
    "timezone": "UTC",
    "workHoursByDay": {
        "MONDAY": [
            900,
            1730
        ],
        "TUESDAY": [
            900,
            1730
        ],
        "WEDNESDAY": [
            900,
            1730
        ],
        "THURSDAY": [
            900,
            1730
        ],
        "FRIDAY": [
            900,
            1730
        ]
    },
    "workDays": [
        "MONDAY",
        "TUESDAY",
        "WEDNESDAY",
        "THURSDAY",
        "FRIDAY"
    ],
    "isActive": true,
    "showEventNames": false,
    "allowDoubleBooking": false
}'

Modified at 2026-07-23 18:02:16

Delete agent data collection

Get agent connected calendars