快速入门

开发指南

通讯录管理

客户联系

微信客服

身份验证

应用管理

消息推送

素材管理

效率工具

企业支付

企业互联

上下游

会话内容存档

电子发票

家校沟通

家校应用

政民沟通

创建成员

POST/cgi-bin/user/create

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

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

请求参数

Query 参数

access_token

可选

示例值:

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表示女性

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

可选

对返回码的文本描述内容