创建成员
权限说明:仅通讯录同步助手或第三方通讯录应用可调用。
注意,每个部门下的部门、成员总数不能超过3万个。建议保证创建department对应的部门和创建成员是串行化处理。
请求参数
成员UserID。对应管理端的帐号,企业内必须唯一。长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成,且第一个字符必须是数字或字母。系统进行唯一性检查时会忽略大小写。
成员名称。长度为1~64个utf8字符
成员别名。长度1~64个utf8字符
手机号码。企业内必须唯一,mobile/email二者不能同时为空
成员所属部门id列表,不超过100个
部门内的排序值,默认为0,成员次序以创建时间从小到大排列。个数必须和参数department的个数一致,数值越大排序越前面。有效的值范围是[0, 2^32)
职务信息。长度为0~128个字符
性别。1表示男性,2表示女性
邮箱。长度6~64个字节,且为有效的email格式。企业内必须唯一,mobile/email二者不能同时为空
企业邮箱。仅对开通企业邮箱的企业有效。长度6~64个字节,且为有效的企业邮箱格式。企业内必须唯一。未填写则系统会为用户生成默认企业邮箱(由系统生成的邮箱可修改一次,2022年4月25日之后创建的成员需通过企业管理后台-协作-邮件-邮箱管理-成员邮箱修改)
直属上级UserID,设置范围为企业内成员,可以设置最多5个上级
启用/禁用成员。1表示启用成员,0表示禁用成员
成员头像的mediaid,通过素材管理接口上传图片获得的mediaid
座机。32字节以内,由纯数字、“-”、“+”或“,”组成。
地址。长度最大128个字符
自定义字段。自定义字段需要先在WEB管理端添加,见扩展属性添加方法,否则忽略未知属性的赋值。
是否邀请该成员使用企业微信(将通过微信服务通知或短信或邮件下发邀请,每天自动下发一次,最多持续3个工作日),默认值为true。
对外职务,如果设置了该值,则以此作为对外展示的职务,否则以position来展示。长度12个汉字内
成员对外属性,字段详情见对外属性
视频号名字(设置后,成员将对外展示该视频号)。须从企业绑定到企业微信的视频号中选择,可在“我的企业”页中查看绑定的视频号
示例代码
返回响应
对返回码的文本描述内容