---
title: "Create exported calendar link"
method: POST
path: "/icalendar-api/exported-calendars"
tags: ["Calendar Sync (iCal export)"]
---

# Create exported calendar link

`POST /icalendar-api/exported-calendars`

When you export your Guesty calendar to an external service, 
    the events from the Guesty calendar will block the external calendar. 
    You must create an exported calendar entity to export data from Guesty via the iCalendar link. 
    This entity stores the settings used during the export process, such as the URL, state, and adjustments.
    Once the entity is created, the export sync process will be triggered. 
    Please note that you can only have one exported calendar per listing. 
    After posting your request, you will receive an exported calendar descriptor, which includes the URL property. 
    You will use this URL in your other services to pull data from Guesty.

## Request body

- object
  - `listingId` string, required — Listing id
  - `adjustmentValueStart` -2 | -1 | 0 | 1 | 2, required — Start date offset
  - `adjustmentValueEnd` -2 | -1 | 0 | 1 | 2, required — End date offset

## Response `200`

Exported calendar created successfully

- object
  - `id` string, required — Id of an exported calendar
  - `listingId` string, required — Related listing id
  - `accountId` string, required — Related account id
  - `createdAt` string, required — Time of creation of an exported calendar
  - `updatedAt` string, required — Time of last update of an exported calendar
  - `url` string, required — URL of an exported calendar
  - `lastSyncedAt` string, required — Timestamp of last successful sync of an exported calendar
  - `adjustmentValueStart` number, required — Defines offset for start date of exported calendar events
  - `adjustmentValueEnd` number, required — Defines offset for end date of exported calendar events

## Other responses

- `201`
- `401` — Client unauthorized
- `404` — Listing not found

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)