接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：createTag

本接口用于创建公众号标签。

开发者可以使用用户标签管理的相关接口，实现对公众号的标签进行创建、查询、修改、删除等操作，也可以对用户进行打标签、取消标签等操作。

1. 调用方式

HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKEN

云调用

调用方法：officialAccount.tags.create
出入参和 HTTPS 调用相同，调用方式可查看云调用说明文档。

第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：2、100
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看第三方调用说明文档。

2. 请求参数

查询参数 `Query String Parameters`

参数名	类型	必填	说明
access_token	string	是	接口调用凭证，可使用 access_token、authorizer_access_token

请求体 `Request Payload`

参数名	类型	必填	说明
tag	object	是	标签信息

Body.tag `Object Payload`

标签信息

参数名	类型	必填	说明
name	string	是	标签名（30个字符以内）

3. 返回参数

返回体 `Response Payload`

参数名	类型	说明
tag	object	标签信息

Res.tag `Object Payload`

标签信息

参数名	类型	说明
id	number	标签ID
name	string	标签名

4. 注意事项

一个公众号最多可以创建100个标签

5. 代码示例

请求示例

{
  "tag": {
    "name": "广东"
  }
}

返回示例

{
  "tag": {
    "id": 134,
    "name": "广东"
  }
}

6. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述	解决方案
-1	system error	系统繁忙，此时请开发者稍候再试
40001	invalid credential access_token isinvalid or not latest	access_token 无效或不为最新获取的 access_token，请开发者确认access_token的有效性
41001	access_token missing	缺少 access_token 参数
42001	access_token expired	access_token 超时，请检查 access_token 的有效期，请参考基础支持 - 获取 access_token 中，对 access_token 的详细机制说明
44002	empty post data	传递的参数为空
45009	reach max api daily quota limit	超出接口每日调用限制
45056	标签数超限	适当删减标签
45157	标签名非法	检查标签名
45158	标签名超长	检查标签名
47001	post data format error	参数格式错误
48001	api unauthorized	api 功能未授权，请确认公众号/服务号已获得该接口，可以在「公众平台官网 - 开发者中心页」中查看接口权限
50002	user limited	用户受限，可能是用户帐号被冻结或注销
61007	api is unauthorized to component	尚未将对应的权限集授权给第三方平台
61016	function category of API need be confirmed by component

7. 适用范围

本接口在不同账号类型下的可调用情况：

公众号	服务号
仅认证	仅认证

仅认证：表示仅允许企业主体已认证账号调用，未认证或不支持认证的账号无法调用。
其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。

创建标签