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

POST

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

调用本接口邀请其他组织企业账号加入。

使用说明

邀请其他组织企业账号加入接口，仅支持购买开通的组织使用。

权限

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

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

关于extension参数的使用

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

登录新版钉钉管理后台。

例如，在通讯录 > 内部通讯录设置 > 通讯录信息页面，单击添加自定义字段按钮。如下图所示，新增字段名称为“爱好”，字段类型为“文本”的自定义字段。

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/v2/user/create?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
        "extension":"{\"爱好\":\"旅游\",\"年龄\":\"24\"}",
        "manager_userid":"001",
        "outer_exclusive_userid":"需要添加的企业账号所属userid",
        "outer_exclusive_corpid":"需要添加的企业账号所属corpid",
        "remark":"备注信息",
        "title":"技术总监",
        "hired_date":"1597573616828",
        "userid":"zhangsan",
        "org_email_type":"profession",
        "work_place":"未来park",
        "dept_order_list":{
                "dept_id":"2",
                "order":"1"
        },
        "senior_mode":"false",
        "dept_id_list":"2",
        "job_number":"4",
        "email":"test@xxx.com",
        "telephone":"010-86123456-2345",
        "dept_title_list":{
                "dept_id":"2",
                "title":"资深产品经理"
        },
        "org_email":"test@xxx.com",
        "name":"张三",
}'

响应示例

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

修改于 2024-01-08 07:35:02

创建钉钉自建企业账号

更新企业账号用户信息

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

使用说明#

权限#

关于extension参数的使用#

请求参数

返回响应

使用说明

权限

关于extension参数的使用