创建用户
POST
/topapi/v2/user/create说明
调用本接口创建新用户。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
请求参数
调用服务端API授权凭证,可通过获取企业内部应用的access_token接口获取。
员工唯一标识ID(不可修改),企业内必须唯一。长度为1~64个字符,如果不传,将自动生成一个userid。
员工名称,长度最大80个字符。
手机号码,企业内必须唯一,不可重复。如果是国际号码,请使用+xx-xxxxxx的格式。
是否号码隐藏:true:隐藏隐藏手机号后,手机号在个人资料页隐藏,但仍可对其发DING、发起钉钉免费商务电话。false:不隐藏
分机号,长度最大50个字符。企业内必须唯一,不可重复。
员工工号,长度最大为50个字符。
直属主管的userId。
职位,长度最大为200个字符。
员工邮箱,长度最大50个字符。企业内必须唯一,不可重复。
员工的企业邮箱,长度最大100个字符。员工的企业邮箱已开通,才能增加此字段。
员工的企业邮箱类型,仅对支持的组织生效(profession: 标准版,base: 基础版)。
办公地点,长度最大100个字符。
备注,长度最大2000个字符。
所属部门id列表,可通过获取部门列表接口获取。
员工在对应的部门中的排序。
员工在部门中的排序。
员工在对应的部门中的职位。
员工在部门中的职位。
扩展属性,可以设置多种属性,最大长度2000个字符。在使用该参数前,需要先在OA管理后台增加该属性,然后再调用接口进行赋值。详情请参见关于extension参数的使用。手机上最多只能显示10个扩展属性。该字段的值支持链接类型填写,同时链接支持变量通配符自动替换,目前支持通配符有:userid,corpid。例如: 工位地址。
是否开启高管模式:true:开启。开启后,手机号码对所有员工隐藏。普通员工无法对其发DING、发起钉钉免费商务电话。高管之间不受影响。false:不开启。
入职时间,Unix时间戳,单位毫秒。
是否专属帐号。为true时,不能指定loginEmail或mobile)。
专属帐号类型:sso:企业自建专属帐号dingtalk:钉钉自建专属帐号
钉钉专属帐号登录名。
钉钉专属帐号初始密码。
{
"extension": "{\"爱好\":\"旅游\"}",
"mobile": "185xxxx7676",
"remark": "备注备注",
"telephone": "010-8xxxxx6-2345",
"hide_mobile": false,
"hired_date": 1597573616828,
"title": "技术总监",
"userid": "zhangsan",
"dept_title_list": [
{
"dept_id": 2,
"title": "资深产品经理"
},
{
"dept_id": 3,
"title": "资深产品经理"
}
],
"work_place": "未来park",
"dept_order_list": [
{
"dept_id": 2,
"order": 1
},
{
"dept_id": 3,
"order": 1
}
],
"senior_mode": false,
"org_email": "test@xxx.com",
"name": "张三",
"dept_id_list": "2,3",
"job_number": "4",
"email": "test@xxx.com"
}
示例代码
返回响应
调用失败时返回的错误信息。
员工的userid。
{
"request_id": "string",
"errcode": 0,
"errmsg": "string",
"result": {
"userid": "string"
}
}