创建用户
POST
/user/create说明
调用本接口创建新用户。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
请求参数
调用服务端API授权凭证,可通过获取企业内部应用的access_token接口获取。
员工唯一标识ID(不可修改),企业内必须唯一。长度为1~64个字符,如果不传,将自动生成一个userid。
是否开启高管模式:true:开启。开启后,手机号码对所有员工隐藏。普通员工无法对其发DING、发起钉钉免费商务电话。高管之间不受影响。false:不开启。
是否号码隐藏:true:隐藏。隐藏手机号后,手机号在个人资料页隐藏,但仍可对其发DING、发起钉钉免费商务电话。false:不隐藏。
员工工号,对应显示到OA后台和客户端个人资料的工号栏目。长度为0~64个字符。
员工邮箱。长度为0~64个字符。企业内必须唯一,不可重复。
员工直属主管的userid。
备注。长度为0~1000个字符。
办公地点。长度为0~50个字符。
分机号。长度为0~50个字符,企业内必须唯一,不可重复。
手机号码,企业内必须唯一,不可重复。
职位信息。长度为0~64个字符。
设置用户在每个部门下的职位。Key是deptId,表示部门;Value是职位,表示在这个部门下的职位。
成员所属部门ID列表,多个ID之间使用英文逗号分隔。
成员名称。长度为1~64个字符。
扩展属性,可以设置多种属性。手机上最多只能显示10个扩展属性,可登录OA管理后台>设置>通讯录信息进行设置。查看扩展属性:链接类型扩展属性,只支持在“移动端钉钉-点击该用户头像-个人资料页”查看,点击链接可以跳转。链接类型支持变量通配符自动替换,目前支持通配符有:userid,corpid。例如: 工位地址。非链接类型扩展属性,支持在“移动端钉钉/PC端钉钉-点击该用户头像-个人资料页”查看。
员工的企业邮箱,如果员工已经开通了企业邮箱,接口会返回,否则会报错。
在对应的部门中的排序,Map结构的json字符串。Key是部门的ID,Value是人员在这个部门的排序值。
入职时间,Unix时间戳。
{
"orderInDepts": "{1995:1}",
"mobile": "138xxxx0000",
"remark": "测试用户",
"userid": "user1",
"managerUserid": "manager240",
"isHide": "true",
"orgEmail": "1@dingtalk.com",
"jobnumber": "1001",
"isSenior": "true",
"hiredDate": 1599735213000,
"name": "张x",
"extattr": "{\"爱好\":\"读书\"}",
"positionInDepts": "{\"1\":\"技术支持\"}",
"tel": "8646xxxx",
"position": "技术支持",
"department": "[379661095,1]",
"email": "1@example.com",
"workPlace": "杭州"
}
示例代码
返回响应
员工的unionId。
{
"errcode": 0,
"errmsg": "string",
"userid": "string",
"unionId": "string"
}