创建单位

POST

/open-apis/contact/v3/unit

自建应用

使用该接口创建单位，需要有更新单位的权限。注意：单位功能属于旗舰版付费功能，企业需开通对应版本才可以创建单位。

错误码

HTTP状态码	错误码	描述	排查建议
500	40003	internal error	内部错误，请提供 X-Request-Id向客服反馈。联系客服。
400	43050	unit feature is prohibited	单位是旗舰版功能，需企业开通相应版本
400	43051	unit_id invalid	非法的单位ID
400	43052	unit name invalid	非法的单位名字，长度需为1-100个字
400	43053	unit type invalid	非法的单位类型，长度需为1-100个字
400	43056	duplicate unit id error	自定义的单位ID已存在，请更换后重试
400	43055	unit name and type repeat	单位名字和类型同时重复。同一企业内，不允许单位名字和类型同时重复

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/contact/v3/unit' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "unit_id": "BU121",
    "name": "消费者事业部",
    "unit_type": "事业部"
}'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "unit_id": "BU121"
  }
}

请求参数

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

unit_id

string

必需

单位自定义ID。不带默认自动生成。1-64字节范围大小，需为数字字母示例值："BU121"

name

string

必需

单位的名字，长度范围为1-100个字示例值："消费者事业部"

unit_type

string

必需

单位类型，长度范围为1-100个字，创建后不可修改示例值："事业部"

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

unit_id

string

单位的自定义ID

必需

修改于 2023-01-12 07:00:35

资源介绍

删除单位

创建单位

错误码#

请求参数

返回响应

错误码