管理企业标签-添加企业客户标签
POST
/cgi-bin/externalcontact/add_corp_tag
服务端API企业内部开发第三方应用开发
注意:
如果要向指定的标签组下添加标签,需要填写group_id参数;如果要创建一个全新的标签组以及标签,则需要通过group_name参数指定新标签组名称,如果填写的groupname已经存在,则会在此标签组下新建标签。
如果填写了group_id参数,则group_name和标签组的order参数会被忽略。
不支持创建空标签组。
标签组内的标签不可同名,如果传入多个同名标签,则只会创建一个。
原文档地址:
https://open.work.weixin.qq.com/api/doc/90000/90135/92117
https://open.work.weixin.qq.com/api/doc/90001/90143/92696
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_corp_tag?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"group_id":"GROUP_ID","group_name":"GROUP_NAME","order":1,"tag":[{"name":"TAG_NAME_1","order":1},{"name":"TAG_NAME_2","order":2}],"agentid":1000014}'
响应示例响应示例
{
"errcode": 0,
"errmsg": "ok",
"tag_group": {
"group_id": "TAG_GROUPID1",
"group_name": "GOURP_NAME",
"create_time": 1557838797,
"order": 1,
"tag": [
{
"id": "TAG_ID1",
"name": "NAME1",
"create_time": 1557838797,
"order": 1
},
{
"id": "TAG_ID2",
"name": "NAME2",
"create_time": 1557838797,
"order": 2
}
]
}
}
请求参数
Query 参数
access_token
调用接口凭证
示例值:
{{accesstoken}}
Body 参数application/json
返回响应
修改于 2022-01-14 04:25:42