---
title: "Create Calendar"
method: POST
path: "/calendar"
tags: ["Calendar"]
---

# Create Calendar

`POST /calendar`

Create a new calendar

## Query parameters

- `select` string

## Request body

- Calendar
  - `id` string, uuid — Calendar ID
  - `created_at` string, timestamp with time zone — Creation date
  - `updated_at` string, timestamp with time zone — Latest update
  - `organisation_id` string, uuid — Organisation ID
  - `name` string, text — Name of the calendar
  - `type` 'virtual' | 'provider', public.calendar_type — Calendar type (virtual or provider). Only virtual calendars can be created via the API.
  - `external_id` string, text, nullable — External ID

## Response `200`

The updated Calendar object

- Calendar
  - `id` string, uuid — Calendar ID
  - `created_at` string, timestamp with time zone — Creation date
  - `updated_at` string, timestamp with time zone — Latest update
  - `organisation_id` string, uuid — Organisation ID
  - `name` string, text — Name of the calendar
  - `type` 'virtual' | 'provider', public.calendar_type — Calendar type (virtual or provider). Only virtual calendars can be created via the API.
  - `external_id` string, text, nullable — External ID

## Other responses

- `201` — The Calendar was created
- `204` — No Content

---

[API](https://skmtc.dev/getmateo/apis/mateo-api.md) · [All operations](https://skmtc.dev/getmateo/apis/mateo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getmateo/mateo-api/revisions/22a9b3b009d1/schema)