---
title: "Select a sub-calendar for conflict checking"
method: POST
path: "/appointments/calendars/selected"
tags: ["Appointments"]
---

# Select a sub-calendar for conflict checking

`POST /appointments/calendars/selected`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/appointments/calendars/selected`
- Auth: HTTP bearer

Add a sub-calendar to the caller's conflict-checking set.
Reuses the in-app select_calendar logic (credential ownership check +
create_selected_calendar). Raises 404 when the credential is not found
or does not belong to the caller.

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- SelectCalendarRequest
  - `credential_id` integer, required
  - `integration` string, required
  - `external_id` string, required

## Response `201`

Successful Response

- SelectedCalendarEnvelope: Envelope for POST /calendars/selected.
  - `data` SelectedCalendarResponse, required
    - `id` string, required
    - `integration` string, required
    - `external_id` string, required
    - `credential_id` integer, nullable

## Other responses

- `422`: Validation Error

---

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