Skip to main content
Version: v22.07

批量创建分组

接口概述#

  • 功能:批量新建分组
  • 请求方式: POST
  • 请求地址:/api/contacts/teams/{team_id}/groups/batch

请求参数#

参数名类型必须参数位置描述示例值
groupsarray[object]body要添加的分组列表
groups[_].namestringbody分组名称测试分组
groups[_].parent_idintegerbody上级分组ID0
groups[_].orderintegerbody排序1
groups[_].remote_idstringbody用户ID
team_idintegeruri团队ID30

响应参数#

响应示例#

  • 请求成功
{    "code": "OK",    "error": {        "type": ""    },    "data": {},    "request_id": "10595b0f-9333-4ad7-8bda-ce2c00119758"}
  • 请求失败
{    "code": "InvalidArgument",    "error": {        "type": "invalid_param"    },    "data": {},    "request_id": "793fb149-4f12-4439-aa83-01d0e211b15c"}

错误码#

error.type 错误代码错误描述
group_create_error创建不成功
invalid_argument参数错误
claim_error无权限