管理企业标签-添加企业客户标签

企业可通过此接口向客户标签库中添加新的标签组和标签，每个企业最多可配置3000个企业标签。
注意:
如果要向指定的标签组下添加标签，需要填写group_id参数；如果要创建一个全新的标签组以及标签，则需要通过group_name参数指定新标签组名称，如果填写的groupname已经存在，则会在此标签组下新建标签。
如果填写了group_id参数，则group_name和标签组的order参数会被忽略。
不支持创建空标签组。
标签组内的标签不可同名，如果传入多个同名标签，则只会创建一个。

文档ID: 17298
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/92117
https://open.work.weixin.qq.com/api/doc/90001/90143/92696

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": "string", "tag_group": { "create_time": 0, "group_id": "string", "group_name": "string", "tag": [ { "create_time": 0, "name": "string", "id": "string", "order": 0 } ], "order": 0 } }

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

agentid

integer <int32>

可选

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

group_id

string

标签组id

可选

group_name

string

可选

标签组名称，最长为30个字符

tag

array [object {2}]

可选

name

string

可选

order

integer <int32>

可选

标签组次序值。order值大的排序靠前。有效的值范围是[0, 2^32)

order

integer <int32>

可选

标签组次序值。order值大的排序靠前。有效的值范围是[0, 2^32)

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

tag_group

object

可选

create_time

integer <int32>

标签组创建时间

可选

group_id

string

标签组id

可选

group_name

string

标签组名称

可选

tag

array [object {4}]

标签组内的标签列表

可选

order

integer <int32>

可选

标签组次序值。order值大的排序靠前。有效的值范围是[0, 2^32)