Open WeCom Skills

English

简体中文

English

简体中文

Appearance

WeCom Global Error Codes ​

Source: https://developer.work.weixin.qq.com/document/path/90313 Query Tool: https://developer.work.weixin.qq.com/devtool/query

Developers should check errcode for error handling. Do not rely on errmsg text matching (errmsg may change). If request parameters do not conform to JSON spec, errmsg will contain "Warning: wrong json format.".

General Error Codes ​

errcodeDescriptionTroubleshooting
-1系统繁忙稍后重试（建议最多 3 次，间隔递增）
0请求成功—

40xxx — Invalid Parameters ​

errcodeDescriptionTroubleshooting
40001不合法的 secret 参数检查 corpsecret 是否正确、是否有首尾空格、应用是否启用
40003不合法的 UserID成员不存在或 userid 格式错误
40004不合法的媒体文件类型检查文件类型限制（image/voice/video/file）
40005不合法的文件类型检查上传文件的扩展名
40006不合法的文件大小图片≤10MB，语音≤2MB，视频≤10MB，普通文件≤20MB
40007不合法的媒体文件 idmedia_id 无效或已过期（临时素材3天有效）
40009不合法的图片文件大小图片大小超限
40011不合法的视频文件大小视频大小超限
40013不合法的 CorpID管理后台 → 我的企业 → 企业信息 查看正确 CorpID
40014不合法的 access_tokentoken 过期、错误或与 agentid 不匹配
40016不合法的按钮个数自定义菜单按钮数量超限
40017不合法的按钮类型检查 type 值是否在 view/click/view_miniprogram 等范围内
40018不合法的按钮名字长度按钮名称超长
40019不合法的按钮 KEY 长度click 类型按钮的 key 超长
40020不合法的按钮 URL 长度view 类型按钮的 url 超长
40022不合法的子菜单级数最多一级子菜单
40023不合法的子菜单按钮个数子菜单最多 5 个按钮
40029不合法的 oauth_codecode 已使用或过期（5分钟有效）
40032不合法的 UserID 列表批量操作时 userid 列表格式错误
40035不合法的外部联系人参数external_userid 无效
40039不合法的 url 长度URL 超长
40054不合法的子菜单 url 域名域名不在可信域名列表
40055不合法的子菜单 button url 域名域名不在可信域名列表
40056不合法的 agentidagentid 格式错误或不存在
40058不合法的参数通用参数错误，检查请求参数格式
40063参数为空必填参数缺失
40066不合法的部门列表部门 ID 相关参数错误
40068不合法的标签 ID标签不存在
40070指定的标签范围结点全部无效标签成员列表无效
40071不合法的标签名字标签名格式或长度不合法
40072不合法的标签名字长度名称超长（最多 32 个字符）
40073不合法的 openidopenid 无效
40074news 消息不支持保密消息类型图文消息不支持 safe=1
40077不合法的 pre_auth_code预授权码无效（服务商接口）
40078不合法的 auth_code授权码无效（服务商接口）
40080不合法的 suite_secret应用套件密钥错误
40082不合法的 suite_token套件 token 无效
40083不合法的 suite_id套件 ID 错误
40084不合法的 suite_ticket套件 ticket 无效
40086不合法的第三方应用 appid第三方应用 ID 错误
40088jobid 不存在异步任务 ID 无效
40089批量任务的 media_id 不存在通讯录批量导入的文件 ID 无效
40091secret 不合法密钥格式错误
40092导入文件存在不合法的内容CSV 文件数据格式有误
40093不合法的 jsapi_ticketJS-SDK ticket 无效
40094不合法的 URLURL 格式错误
40096不合法的外部联系人 userid外部联系人 userid 无效

41xxx — Missing Parameters ​

errcodeDescriptionTroubleshooting
41001缺少 access_token 参数URL 中未携带 access_token
41002缺少 corpid 参数请求缺少 corpid
41004缺少 secret 参数请求缺少 corpsecret
41006缺少 media_id 参数上传/下载素材时未传 media_id
41008缺少 auth_code授权流程缺少 code
41009缺少 userid请求缺少 userid
41010缺少 url回调配置缺少 URL
41011缺少 agentid请求缺少 agentid
41016缺少 title消息缺少标题
41019缺少 department请求缺少部门参数
41025缺少 mediadata上传素材缺少文件数据
41033缺少 description请求缺少描述字段
41035缺少外部联系人参数external_userid 缺失

42xxx — Credential Expired ​

errcodeDescriptionTroubleshooting
42001access_token 已过期刷新 token（有效期 7200 秒）
42007pre_auth_code 已过期重新获取预授权码
42009access_token 与 agentid 不匹配确认 token 和应用属于同一 agentid

43xxx — Permission Denied ​

errcodeDescriptionTroubleshooting
43004指定的 userid 未绑定微信或未关注微信插件成员需先关注企业微信

44xxx — Empty Content ​

errcodeDescriptionTroubleshooting
44001多媒体文件为空上传文件内容为空
44004文本消息 content 为空发送文本消息时 content 不能为空

45xxx — Rate Limit Exceeded ​

errcodeDescriptionTroubleshooting
45002消息内容大小超过限制文本消息不超过 2048 字节
45004应用描述大小超过限制应用描述不超过 300 字符
45009接口调用超过限制触发频率限制，参考 wecom-core 第 4 节
45022应用已禁用应用被管理员禁用
45024帐号数量超过上限成员数超过企业许可上限
45026触发删除用户保护批量删除成员时触发安全保护
45029回调配置的 url 不合法回调 URL 验证失败
45033接口并发调用超过限制降低并发请求数
45035超过批量操作上限批量操作的单次数量超限
45036不允许更新该应用的可见范围应用可见范围受限

46xxx — Not Found ​

errcodeDescriptionTroubleshooting
46003菜单未设置应用未配置自定义菜单
46004指定的 userid 未注册userid 不存在

48xxx — Insufficient Permission ​

errcodeDescriptionTroubleshooting
48001API 功能未授权应用未开通对应 API 权限
48002API 接口无权限调用检查应用可见范围和权限配置
48003不合法的 suite_id套件 ID 不匹配
48004授权关系无效企业取消了授权
48005API 接口已废弃使用新版替代接口
48006接口权限被收回联系管理员重新授权
48007没有指定应用的管理权限当前管理员无此应用管理权

50xxx — User Related ​

errcodeDescriptionTroubleshooting
50001redirect_url 未登记可信域名在管理后台配置可信域名
50002成员不在权限范围成员不在应用可见范围或不在对应标签
50003应用已禁止向该用户发消息用户被屏蔽或未关注

60xxx — Access Control ​

errcodeDescriptionTroubleshooting
60001部门长度不合法部门名称超长
60003部门 ID 不合法部门 ID 格式错误
60004父部门不存在parentid 指向的部门不存在
60005不允许删除有成员的部门需先移除部门下所有成员
60006不允许删除有子部门的部门需先删除子部门
60008部门名称已存在同级下部门名称重复
60009部门名称含有非法字符不允许包含 `\😗?"<>
60010部门存在循环关系不能把父部门设为子部门
60011没有权限访问指定应用agentid 和 secret 不匹配
60020访问 IP 不在白名单之中管理后台添加可信 IP
60028不合法的 corpid，和创建者的企业不一致corpid 与应用所属企业不匹配
60102UserID 已存在创建成员时 userid 重复
60103手机号码不合法手机号格式错误
60104手机号码已存在已绑定其他成员
60105邮箱不合法邮箱格式错误
60106邮箱已存在已绑定其他成员
60107微信号不合法微信号格式错误
60110UserID 不合法仅允许字母、数字、_@.连字符
60111UserID 使用了系统保留字不能使用 test、admin 等
60123无效的部门 id部门不存在

72xxx — Invoice Related ​

errcodeDescriptionTroubleshooting
72023发票已被其他公众号锁定发票状态冲突
72024发票状态错误发票当前状态不允许该操作
72037存在发票不属于该用户用户无权操作该发票

80xxx — App Management ​

errcodeDescriptionTroubleshooting
80001可信域名不正确域名未通过所有权校验
81001部门下的结点数超过限制调整通讯录结构
81003无法操作创建者企业创建者不能被修改或删除
81011无权限操作标签当前应用无标签管理权限
81013标签成员超限单标签成员上限

82xxx — Group Chat ​

errcodeDescriptionTroubleshooting
82001指定的成员 / 部门 / 标签全部无效检查群聊成员列表

84xxx — OAuth / Login ​

errcodeDescriptionTroubleshooting
84014成员票据过期重新获取 user_ticket（5分钟有效）
84015成员票据无效user_ticket 格式错误
84019缺少 templateid审批模板 ID 缺失
84020模板内容不合法检查审批模板 JSON 格式
84024无权限创建该应用创建应用权限不足
84052应用已存在应用名称或 ID 重复
84061缺少 md5文件上传缺少校验码
84066部门预算余额不足企业支付余额不足
84067付款金额不符合规范金额超出范围（1分~5000元）
84069付款备注不合法备注超长或格式错误
84073openid 不合法成员未绑定微信
84074企业支付余额不足充值后重试

85xxx — Domain / ISV ​

errcodeDescriptionTroubleshooting
85002包含非法的外部联系人 IDexternal_userid 不合法
85004每企业每小时仅允许调用一次JS-SDK 域名校验有频率限制
85005没有设置可信域名管理后台配置应用可信域名

86xxx — Chat Archive ​

errcodeDescriptionTroubleshooting
86216存在无效的 external_userid 列表外部联系人 ID 格式错误
86220需要激活互通账号成员需要互通账号许可

90xxx — External Contact ​

errcodeDescriptionTroubleshooting
90207无客户联系权限应用未开通客户联系功能
90208不在配置的使用范围内成员不在客户联系使用范围
90500不合法的 corpid 或 openid参数格式错误

91xxx — Approval ​

errcodeDescriptionTroubleshooting
91040不合法的审批模板 ID审批模板不存在

92xxx — Customer Service ​

errcodeDescriptionTroubleshooting
92002客服账号数或接待人员超限联系管理员扩容

301xxx — Permission Operations ​

errcodeDescriptionTroubleshooting
301002无权限操作指定的应用 / 成员成员不在应用可见范围内
301005不允许删除创建者企业创建者不可删除
301012参数 position 不合法职务字段超长
301013参数 telephone 不合法座机号格式错误
301014参数 english_name 不合法英文名超长
301021被授权的应用配额不足应用许可数不够
301022设置的成员数目超限标签或部门成员数超限
301024超出配额数资源配额耗尽
301025不允许在非通讯录同步助手中获取全部成员仅通讯录同步助手支持全量成员操作
301036不允许转移的客户不属于该成员转移客户时源成员不匹配
301055创建群发失败，附件体积超限群发附件体积超过 10MB

610xxx — Customer Service Exclusive ​

errcodeDescriptionTroubleshooting
610001客服开放接口未启用管理后台开启客服 API
610003客服 userid 不存在客服成员 ID 无效
610004客服账号不合法客服账号 ID 格式错误
610014无有效的客服接待人员客服账号未配置接待人员
610015客服配额已用完购买更多客服坐席
610017消息不合法客服消息内容格式错误

670xxx — License Related ​

errcodeDescriptionTroubleshooting
670001接口许可过期续费企业微信接口许可

Troubleshooting Methods ​

  1. 错误码查询工具: https://developer.work.weixin.qq.com/devtool/query
  2. 频率解封工具: https://open.work.weixin.qq.com/devtool/checkCorpSpamBlock
  3. API 调试工具: https://developer.work.weixin.qq.com/resource/devtool
  4. 返回的 errmsg 中通常包含 more info at https://open.work.weixin.qq.com/devtool/query?e=错误码
  5. 不确定时，优先检查 access_token 是否正确、IP 是否在白名单、成员是否在可见范围

Released under the Apache 2.0 License.

© 2026 Open WeCom Skills Contributors