#  创建日历
**注意事项**：为了更好地提升该接口的安全性与开放性，我们对其进行了升级。请尽快迁移至[新版本>>](https://open.larksuite.com/document/ukTMukTMukTM/uETM3YjLxEzN24SMxcjN)
该接口用于为应用在企业内创建一个日历。

## 请求

基本 |  
---|---
HTTP URL | https://open.larksuite.com/open-apis/calendar/v3/calendars
HTTP Method | POST

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：获取与使用access_token](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 请求体  <br>
|参数|类型|必须|说明|
|--|-----|--|----|----|
|summary|string|是|日历标题，最大长度为 256|
|description|string|否|日历描述，最大长度为 256|
|is_private|bool|否|是否为私有日历，私有日历不可被搜索，默认为false|
|default_access_role|string|否|表示用户的默认访问权限。取值如下：<br>reader: 订阅者，可查看日程详情<br>free_busy_reader: 游客，只能看到"忙碌/空闲"|

### 请求体示例
```json
{
	"summary":"calendar title",
    "description":"this is a test calendar",
    "is_private":true,
    "default_access_role":"free_busy_reader"
}
```

## 响应
### 响应体
|参数|说明|
|-|-|
|code|返回码，非 200000 表示失败|
|msg|返回码的描述|
|data|返回业务信息|
|&emsp;∟id|日历 ID|
|&emsp;∟summary|日历标题|
|&emsp;∟description|日历描述|
|&emsp;∟is_private|是否为私有日历，私有日历不可被搜索|
|&emsp;∟default_access_role|用户的默认访问权限|
### 响应体示例 
```json
{
    "code": 200000,
    "msg": "success",
    "data": {
        "id": "larksuite.com_xxxxxxxxxx@group.calendar.larksuite.com",
        "summary": "calendar title",
        "description": "this is a test calendar",
        "default_access_role": "free_busy_reader"
    }  
}
```
### 错误码

具体可参考：[服务端错误码说明](https://open.larksuite.com/document/ukTMukTMukTM/ugjM14COyUjL4ITN)