企业微信 API
企业内部开发
第三方应用开发
智慧硬件开发
企业微信 API
目录
快速入门
开发指南
通讯录管理
客户联系
微信客服
身份验证
应用管理
消息推送
素材管理
OA
效率工具
企业支付
企业互联
上下游
会话内容存档
电子发票
家校沟通
家校应用
政民沟通
Powered by Apifox

创建成员

POST/cgi-bin/user/create

权限说明:仅通讯录同步助手或第三方通讯录应用可调用。

注意,每个部门下的部门、成员总数不能超过3万个。建议保证创建department对应的部门和创建成员是串行化处理。

请求参数

Query 参数
access_token
可选
示例值:
{{accesstoken}}
Body 参数 (application/json)
userid
string 
必需

成员UserID。对应管理端的帐号,企业内必须唯一。长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成,且第一个字符必须是数字或字母。系统进行唯一性检查时会忽略大小写。

name
string 
必需

成员名称。长度为1~64个utf8字符

alias
string 
可选

成员别名。长度1~64个utf8字符

mobile
string 
可选

手机号码。企业内必须唯一,mobile/email二者不能同时为空

department
array[integer]
必需

成员所属部门id列表,不超过100个

order
array[integer]
可选

部门内的排序值,默认为0,成员次序以创建时间从小到大排列。个数必须和参数department的个数一致,数值越大排序越前面。有效的值范围是[0, 2^32)

position
string 
可选

职务信息。长度为0~128个字符

gender
string 
可选

性别。1表示男性,2表示女性

email
string 
可选

邮箱。长度6~64个字节,且为有效的email格式。企业内必须唯一,mobile/email二者不能同时为空

biz_mail
string 
可选

企业邮箱。仅对开通企业邮箱的企业有效。长度6~64个字节,且为有效的企业邮箱格式。企业内必须唯一。未填写则系统会为用户生成默认企业邮箱(由系统生成的邮箱可修改一次,2022年4月25日之后创建的成员需通过企业管理后台-协作-邮件-邮箱管理-成员邮箱修改)

is_leader_in_dept
array[integer]
可选

个数必须和参数department的个数一致,表示在所在的部门内是否为部门负责人。1表示为部门负责人,0表示非部门负责人。在审批(自建、第三方)等应用里可以用来标识上级审批人

direct_leader
array[string]
必需

直属上级UserID,设置范围为企业内成员,可以设置最多5个上级

enable
integer 
可选

启用/禁用成员。1表示启用成员,0表示禁用成员

avatar_mediaid
string 
可选

成员头像的mediaid,通过素材管理接口上传图片获得的mediaid

telephone
string 
可选

座机。32字节以内,由纯数字、“-”、“+”或“,”组成。

address
string 
可选

地址。长度最大128个字符

main_department
integer 
主部门
可选
extattr
object {1} 
可选

自定义字段。自定义字段需要先在WEB管理端添加,见扩展属性添加方法,否则忽略未知属性的赋值。

attrs
array [object {4}] 
必需
to_invite
boolean 
可选

是否邀请该成员使用企业微信(将通过微信服务通知或短信或邮件下发邀请,每天自动下发一次,最多持续3个工作日),默认值为true。

external_position
string 
可选

对外职务,如果设置了该值,则以此作为对外展示的职务,否则以position来展示。长度12个汉字内

external_profile
object {3} 
可选

成员对外属性,字段详情见对外属性

external_corp_name
string 
必需
wechat_channels
object {1} 
必需
external_attr
array [object {5}] 
必需
nickname
string 
可选

视频号名字(设置后,成员将对外展示该视频号)。须从企业绑定到企业微信的视频号中选择,可在“我的企业”页中查看绑定的视频号

示例

示例代码

返回响应

成功(200)
HTTP 状态码: 200
内容格式: JSON
数据结构
errcode
integer <int32>
返回码
可选
errmsg
string 
可选

对返回码的文本描述内容

示例

【企业微信】API开发者 微信交流群

用微信扫右侧二维码,加入【企业微信】API开发者 交流群,互助沟通

扫码加入交流群
Apifox当前文档由 Apifox 生成
举报