创建用户.md

接口描述

• 描述：创建企业用户。
• 该接口仅适用于手动管理企业通讯录的方式。
• 不支持 SSO 登录。
• 创建用户后，用户状态初始为未激活。
• 暂不支持 OAuth2.0 鉴权访问。
• 调用方式：POST
• 接口请求域名：

https://api.meeting.qq.com/v1/users

输入参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。

参数名称	必选	参数类型	参数描述
email	否	String	邮箱地址，同企业内须保证唯一。与手机号二选一，若同时传入手机号和邮箱，则邮箱字段忽略。
area	否	String	地区编码（默认值为86）。
phone	是	String	手机号码。与邮箱二选一若企业未开通邮箱登录方式，手机号必填。
username	是	String	用户昵称。
userid	是	String	调用方用于标示用户的唯一 ID，最大支持传40字节（例如：企业用户可以为企业账户英文名、员工工号、员工邮箱、手机号等，暂不支持中文）。
staff_id	否	String	员工工号。
job_title	否	String	员工职位，长度范围为[0,96]个字符。
entry_time	否	Integer	入职时间。
department_list	否	String 数组	员工部门 ID，暂只支持为用户分配1个部门。
auto_invite	否	Boolean	自动发送邀请，开启之后调用接口后自动发送激活邀请。 true：开启，默认开启 false：关闭

输出参数

参数名称	参数类型	参数描述
email	String	邮箱地址。
phone	String	手机号码。
username	String	用户昵称。
userid	String	调用方用于标示用户的唯一 ID（例如：企业用户可以为企业账户英文名、个人用户可以为手机号等，暂不支持中文）。
uuid	String	用户身份 ID（腾讯会议颁发的用于开放平台的唯一用户 ID）。

示例

输入示例

POST https://api.meeting.qq.com/v1/users
{
  "username": "testusername",
  "phone": "18888888888",
  "userid": "testuserid",
  "email": "123456@qq.com",
  "staff_id":"6666",
  "job_title":"develop",
  "entry_time":1628495795,
  "department_list":["07f4c****************1966815d251"]
}

输出示例

{
  "username": "testusername",
  "phone": "18888888888",
  "userid": "testuserid",
  "email": "123456@qq.com",
  "uuid": "WM4Fs4Th56ogU13JiK"
}