创建用户

调用该接口创建新的企业用户。

请求

基本
请求方式	`POST`
请求地址	`/openapi/v3/contacts/users`

请求头

名称	类型	必填	描述
Authorization	string	是	值格式：`Bearer {{access_token}}` 调用 API 时，需要通过访问凭证（access_token）进行身份鉴权，不同类型的访问凭证可获取的数据范围不同，参考获取访问凭证。支持鉴权类型： • `应用级token`：以应用身份调用 API，校验应用的数据访问范围。参考获取企业内部应用access_token。 • `用户级token`：以登录用户身份调用 API，校验用户的可见数据范围。参考获取登录用户access_token。
Content-Type	string	是	固定值：`application/json; charset=utf-8`

请求体

请求参数

名称	类型	必填	描述
name	string	是	姓名，1-64字符
department_ids	array[string]	是	部门ID列表，至少一个
mobile	string	否	手机号（合法手机号校验），mobile、email、username 不能同时为空
email	string	否	邮箱（合法邮箱校验），mobile、email、username 不能同时为空
alias_id	string	否	自定义用户ID，不超过64字符
employee_number	string	否	工号，不超过64字符
position	string	否	职位，不超过100字符
join_time	string	否	入职时间，格式：2006-01-02
username	string	否	SSO登录名，mobile，mobile、email、username 不能同时为空，不超过64字符

请求体示例


  1{
  2  "name": "zyxtest",
  3  "mobile": "+86 15012453582",
  4  "email": "xx@qq.com",
  5  "department_ids": [
  6    "923168858645200896"
  7  ],
  8  "alias_id": "IDzyxtest00001",
  9  "employee_number": "458152",
 10  "position": "架构师",
 11  "join_time": "2023-09-01",
 12  "username": "zyxtest"
 13}

响应

响应体


  1{
  2  "code": 0,
  3  "msg": "success",
  4  "data": {
  5    "union_id": "2132131232113123"
  6  }
  7}