日历接口创建日历

该接口用于通过应用在企业内创建一个日历。
注: 企业微信需要更新到3.0.2及以上版本

文档ID: 26902
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93647
https://open.work.weixin.qq.com/api/doc/90001/90143/93702

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/oa/calendar/add?access_token=' \ --header 'Content-Type: application/json' \ --data-raw '{ "calendar": { "admins":[ "admin1", "admin2" ], "set_as_default": 1, "summary": "test_summary", "color": "#FF3030", "description": "test_describe", "shares": [{ "userid": "userid2" }, { "userid": "userid3", } ], "is_public": 1, "public_range": { "userids": ["abel", "jack"], "partyids": [1232, 34353] }, "is_corp_calendar": 1 }, "agentid": 1000014 }'

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

calendar

object

日历信息

必需

admins

array[string]

可选

日历的管理员userid列表，管理员必须在通知范围成员的列表中。最多指定3人

set_as_default

integer

可选

是否将该日历设置为access_token所对应应用的默认日历。 0-否；1-是。默认为0，即不设为默认日历第三方应用不支持使用该参数

summary

string

必需

日历标题。1 ~ 128 字符

color

string

必需

日历在终端上显示的颜色，RGB颜色编码16进制表示，例如："#0000FF" 表示纯蓝色

description

string

可选

日历描述。0 ~ 512 字符

array [object {1}]

必需

日历通知范围成员列表。最多2000人

is_public

integer

可选

是否公共日历。0-否；1-是。注意：每个人最多可创建或订阅100个公共日历。该属性不可更新

public_range

object

可选

公开范围。仅当是公共日历时有效

is_corp_calendar

integer

可选

是否全员日历。0-否；1-是。注意： 1. 每个企业最多可创建20个全员日历 2. 全员日历也是公共日历的一种，需要指定public_range 3. 全员日历不支持指定颜色、默认日历、只读权限 4. 该属性不可更新

agentid

integer

必需

授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数

示例

日历接口 创建日历

请求参数

返回响应