创建用户

POST {{base_url}}/contact/v3/users

使用该接口向通讯录创建一个用户,可以理解为员工入职。创建用户后只返回有数据权限的数据。具体的数据权限的与字段的对应关系请参照应用权限常见问题答疑

参考接口文档:创建用户

Request Params

KeyDatatypeRequiredDescription
user_id_typestring用户 ID 类型。可选值:open_id、union_id、user_id
department_id_typestring此次调用中使用的部门ID的类型。

不同 ID 的说明以及获取方式参见 部门ID说明 | | client_token | string | | 根据client_token是否一致来判断是否为同一请求 |

Request Body

{"avatar_key"=>"2500c7a9-5fff-4d9a-a2de-3d59614ae28g", "city"=>"杭州", "country"=>"CN", "custom_attrs"=>[{"id"=>"DemoId", "type"=>"TEXT", "value"=>{"generic_user"=>{"id"=>"9b2fabg5", "type"=>1}, "option_id"=>"edcvfrtg", "pc_url"=>"http://www.feishu.cn", "text"=>"DemoText", "url"=>"http://www.feishu.cn"}}], "department_ids"=>["od-4e6ac4d14bcd5071a37a39de902c7141"], "description"=>"", "email"=>"zhangsan@gmail.com", "employee_no"=>"1", "employee_type"=>1, "en_name"=>"San Zhang", "ent_email_password"=>"", "enterprise_email"=>"demo@mail.com", "gender"=>1, "idp_type"=>"", "job_title"=>"xxxxx", "join_time"=>2147483647, "leader_user_id"=>"ou_7dab8a3d3cdcc9da365777c7ad535d62", "mobile"=>"中国大陆手机号: 13011111111 或 +8613011111111, 境外手机号:  +41446681800", "mobile_visible"=>false, "name"=>"张三", "need_send_notification"=>false, "nickname"=>"Alex Zhang", "notification_option"=>{"channels"=>[""], "language"=>"zh-CN"}, "orders"=>[{"department_id"=>"od-4e6ac4d14bcd5071a37a39de902c7141", "department_order"=>100, "user_order"=>100}], "positions"=>[{"department_id"=>"", "is_major"=>false, "leader_position_code"=>"", "leader_user_id"=>"", "position_code"=>"", "position_name"=>""}], "user_id"=>"3e3cf96b", "work_station"=>"北楼-H34"}