---
title: "Create Calendar"
method: POST
path: "/api/calendars"
tags: ["Calendars"]
---

# Create Calendar

`POST /api/calendars`

## Request

- Base URL: `https://addcal.co`
- URL: `https://addcal.co/api/calendars`
- Auth: none required

## Request body

- object
  - `name` string, required: Must not be greater than 255 characters.
  - `internal_name` string, nullable: Must not be greater than 255 characters.
  - `description` string, nullable: Must not be greater than 255 characters.
  - `timezone` string, required: Must be a valid time zone, such as <code>Africa/Accra</code>.
  - `week_begins` 1 | 2 | 3 | 4 | 5 | 6 | 0, required

## Other responses

- `409`

---

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