# 添加企业客户标签

请求方式: POST

请求地址: https://nbd-api.myscrm.cn/bff-nbd-qw-openapi/v1/corp-tag/add

请求参数说明:

参数 类型 必须 说明
app_id string 企微中台应用 id
group_id string 签组 id
group_name string 标签组名称,最长为 30 个字符
order int64 标签组次序值。order 值大的排序靠前。有效的值范围是[0, 2^32)
tag.name string 添加的标签名称,最长为 30 个字符
tag.order int64 标签次序值。order 值大的排序靠前。有效的值范围是[0, 2^32)

请求参数示例:

{
  "app_id": "xxxxx",
  "group_id": "GROUP_ID",
  "group_name": "GROUP_NAME",
  "order": 1,
  "tag": [
    {
      "name": "TAG_NAME_1",
      "order": 1
    },
    {
      "name": "TAG_NAME_2",
      "order": 2
    }
  ]
}

返回数据:

{
  "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,
        "deleted": false
      },
      {
        "id": "TAG_ID2",
        "name": "NAME2",
        "create_time": 1557838797,
        "order": 2,
        "deleted": false
      }
    ]
  }
}

返回参数说明:

名称 类型 说明
tag_group.group_id string 标签组 id
tag_group.group_name string 标签组名称
tag_group.create_time int64 标签组创建时间
tag_group.order int64 标签组排序的次序值,order 值大的排序靠前。有效的值范围是[0, 2^32)
tag_group.deleted bool 标签组是否已经被删除,只在指定 tag_id 进行查询时返回
tag_group.tag.id string 标签 id
tag_group.tag.name string 标签名称
tag_group.tag.create_time int64 标签创建时间
tag_group.tag.order int64 标签排序的次序值,order 值大的排序靠前。有效的值范围是[0, 2^32)
tag_group.tag.deleted bool 标签是否已经被删除