创建用户

POST

https://oapi.dingtalk.com/topapi/v2/user/create

调用本接口创建新用户。

说明

调用本接口可以实现创建普通用户或创建企业账号用户。由于在调用时参数使用有较多区别，为便于开发者查看，按照新用户的账号类型进行拆分优化：

如果是创建普通用户，接口说明文档请查看本文介绍。

如果是创建企业账号用户（仅支持购买开通的组织使用），接口说明文档请参见：

创建SSO企业账号

创建钉钉自建企业账号

邀请其他组织企业账号加入

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	维护通讯录的接口访问权限	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

关于extension参数的使用

如果想要展示扩展字段extension中设置的用户属性，您还需要完成以下操作。

登录钉钉管理后台。

单击内部通讯录设置，然后单击成员字段管理 > 添加自定义字段。

请求参数

Query 参数

Body 参数application/json

示例

{
  "userid":"002",
  "name":"小钉",
  "mobile":"185xxxxxxxx",
  "telephone":"010-8xxxxx645",
  "title":"教职人员",
  "job_number":"100828",
  "email":"xxxxx@xxx.com",
  "org_email":"test@xxx.com",
  "org_email_type":"profession",
  "hide_mobile":"false",
  "hired_date":"1615219200000",
  "remark":"备注备注",
  "work_place":"未来park",
  "senior_mode":"false",  
  "deptTitleList":"[{\"dept_id\":4868821xx,\"title\":\"测试\"},{\"dept_id\":6099161xx,\"title\":\"专员\"}]",
  "deptOrderList":"[{\"dept_id\":4868821xx,\"order\":1},{\"dept_id\":6099161xx,\"order\":1}]",
  "dept_id_list":"4868821xx,6099161xx",
  "extension":"{\"爱好\":\"[爱好](http://zdmomo.vaiwan.com?userid=#userid#&corpid=#corpid#)\"}",
  "manager_userid":"001",
  "login_email":"test@xxx.com"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://oapi.dingtalk.com/topapi/v2/user/create?access_token=ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "userid":"002",
  "name":"小钉",
  "mobile":"185xxxxxxxx",
  "telephone":"010-8xxxxx645",
  "title":"教职人员",
  "job_number":"100828",
  "email":"xxxxx@xxx.com",
  "org_email":"test@xxx.com",
  "org_email_type":"profession",
  "hide_mobile":"false",
  "hired_date":"1615219200000",
  "remark":"备注备注",
  "work_place":"未来park",
  "senior_mode":"false",  
  "deptTitleList":"[{\"dept_id\":4868821xx,\"title\":\"测试\"},{\"dept_id\":6099161xx,\"title\":\"专员\"}]",
  "deptOrderList":"[{\"dept_id\":4868821xx,\"order\":1},{\"dept_id\":6099161xx,\"order\":1}]",
  "dept_id_list":"4868821xx,6099161xx",
  "extension":"{\"爱好\":\"[爱好](http://zdmomo.vaiwan.com?userid=#userid#&corpid=#corpid#)\"}",
  "manager_userid":"001",
  "login_email":"test@xxx.com"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": "string",
    "result": {
        "unionId": "string",
        "userid": "string"
    },
    "errmsg": "string"
}

修改于 2025-09-08 06:28:05

获取企业下所有员工信息

更新用户信息

创建用户

权限#

关于extension参数的使用#

请求参数

请求示例代码

返回响应

权限

关于extension参数的使用