---
title: "Choose calendar destination and booking policy"
method: POST
path: "/v1/calendars/{connection_id}/configure"
---

# Choose calendar destination and booking policy

`POST /v1/calendars/{connection_id}/configure`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/calendars/{connection_id}/configure`
- Auth: none declared

Bound to the authenticated organization and a project in that organization. agents:write required. Tokens and provider errors are never returned. selections is an explicit network command, bounded to 100 results with has_more.

## Path parameters

- `connection_id` string, required

## Request body

- object
  - `configuration` CalendarConfiguration, required
    - `allow_test_writes` boolean
    - `buffer_minutes` integer
    - `conflict_ids` string[]
    - `duration_minutes` integer
    - `horizon_days` integer
    - `invite_caller` boolean
    - `location` string
    - `minimum_notice_minutes` integer
    - `target_id` string, required
    - `test_connection` boolean
    - `timezone` string, required: IANA timezone identifier
    - `working_hours` object: Monday=0 through Sunday=6; each value is [start,end] in local minutes since midnight. No overnight intervals.
  - `organization_id` string
  - `project_id` string, required

## Response `200`

Safe connection metadata or bounded selection list

## Other responses

- `400`: Invalid policy or unsupported provider capability
- `404`: Connection not found in this workspace/project

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/95b8c66f99aa?raw)