创建标签

为当前微信实例创建联系人标签。

接口地址： POST /addContactLabel

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 标签名称建议由业务系统统一维护，避免重复创建同义标签。
• 同一个微信实例下，标签名称应保持清晰、可识别。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
labelName	是	string	标签名称

请求示例

{
  "wId": "349be9b5-8734-45ce-811d-4e10ca568c67",
  "labelName": "看一看世界"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object/null	成功时返回标签信息，失败时通常为空
data.labelId	int	标签 ID
data.labelName	string	标签名称

成功响应

{
 "message": "成功",
 "code": "1000",
 "data": {
 "labelId": 3,
 "labelName": "看一看世界"
 }
}

错误响应

{
 "message": "失败",
 "code": "1001",
 "data": null
}

使用建议

• 建议业务系统保存 labelId 与标签业务含义的映射，后续修改联系人标签时会用到。
• 创建前可以先调用「获取标签列表」，避免重复创建同名或同义标签。
• 标签名称尽量使用稳定分组名，避免频繁改名影响运营识别。