---
title: "Set the destination calendar for new booking events"
method: PUT
path: "/appointments/calendars/destination"
tags: ["Appointments"]
---

# Set the destination calendar for new booking events

`PUT /appointments/calendars/destination`

## Request

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

Set (upsert) the destination calendar where booking events are pushed.
Optionally scoped to a specific event type via ``event_type_id``. Reuses
the in-app set_destination_calendar logic (upsert_destination_calendar).

## Headers

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

## Request body

- SetDestinationCalendarRequest
  - `integration` string, required
  - `external_id` string, required
  - `credential_id` integer, nullable
  - `event_type_id` integer, nullable

## Response `200`

Successful Response

- DestinationCalendarEnvelope: Envelope for GET/PUT /calendars/destination. ``data`` is ``null`` when no destination calendar is configured.
  - `data` DestinationCalendarResponse
    - `id` integer, required
    - `integration` string, required
    - `external_id` string, required
    - `credential_id` integer, nullable
    - `event_type_id` integer, nullable
    - `primary_email` string, 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/2e7cfa0ca921?raw)