SDK error codes
Beginning March 2 2026, apps joining meetings outside their account must be authorized. Authorize apps by using either ZAK or OBF tokens, or RTMS. Learn more.
The Meeting SDK for iOS might return errors in the callbacks or as return values. This list provides a description of possible error codes and how to mitigate them. If you receive an error code, cross-check here to get the semantics of the error and how to resolve it.
Can't find the SDK error code you're seeing? Head over to the devforums.
Global SDK error codes
| Description | Error Code | Suggestion |
|---|---|---|
| Success – request is successful. | 0 | None |
| Incorrect meeting number | 1 | Check the meeting ID and start or join the meeting again. |
| Internal Zoom cloud service issue. | 2 | Please contact Zoom support if you receive this error repeatedly |
| Network is not available | 3 | Prompt the user to check the internal network. |
| Zoom MobileRTC stack version is not compatible to connect to the meeting | 4 | Update the iOS SDK to the latest version. |
| Network connection issues | 5 | Check the internal network. |
| Internal error | 6, 7, 11 | Please contact Zoom support if you receive this error repeatedly. |
| The meeting you want to join or start has ended | 8 | Create or join another meeting. |
| The meeting you want to join or start does not exist | 9 | Create or join another meeting. |
| The meeting you want to join is full | 10 | None |
| You are trying to join a locked meeting | 12 | Prompt the user |
| You are trying to join a restricted meeting | 14 | Prompt the user |
| Join before the host is restricted | 15 | Prompt the user |
| Request to web service failed | 16 | Typically, a network error. Retry to start meeting, if you repeated see this, contact zoom support. |
| Number of registered webinar attendees has reached the limit | 17 | None |
| Cannot register a webinar using the host email | 13 | Check if the host email has already been registered with Zoom. |
| Cannot register a webinar using a panelist's email | 18 | Check if the panelist's email has already been registered with Zoom. |
| Registration to this webinar has been denied by the host | 19 | Check the webinar configuration on the Zoom website. |
| This webinar requires participants to login. | 20 | None |
| User leaves the meeting when waiting for the host to start | 21 | None |
| Failed due to one or more invalid arguments. | 99 | Please check the Zoom SDK documentation on function usage. |
| Meeting error | 100 | Please check the Zoom SDK documentation on function usage. |
| Meeting API cannot be called now | 101 | Please contact Zoom support if you receive this error repeatedly. |
Authentication error codes
| Name | Error Code | Description |
|---|---|---|
| `MobileRTCAuthError_Success` | 0 | Authentication is successful. |
| `MobileRTCAuthError_Unknown` | 5 | Unknown error. Please seek help on Zoom Developer Forum. |
| `MobileRTCAuthError_TokenWrong` | 124 | The JWT token to authenticate is wrong. |
| `MobileRTCAuthError_KeyOrSecretEmpty` | 300 | Your SDK key or secret is empty. |
| `MobileRTCAuthError_KeyOrSecretWrong` | 3023 | Your SDK key or secret is invalid. |
| `MobileRTCAuthError_AccountNotSupport` | 3024 | Your account does not support SDK. |
| `MobileRTCAuthError_AccountNotEnableSDK` | 3025 | Your account does not support SDK. |
| `MobileRTCAuthError_OverTime` | 5003 | Request over time. |
| `MobileRTCAuthError_ClientIncompatible` | 3112 | Account does not support this SDK version. |
| `MobileRTCAuthError_NetworkIssue` | Network issue. | |
| `MobileRTCAuthError_None` | Default error type. |
Meeting error codes
| Name | Error Code | Description |
|---|---|---|
| `MobileRTCMeetError_Success` | 0 | Successfully start/join meeting |
| `MobileRTCMeetError_NetworkError` | 1 | Network issue, please check your network connection |
| `MobileRTCMeetError_ReconnectError` | 2 | Failed to reconnect to the meeting |
| `MobileRTCMeetError_MMRError` | 3 | MMR issue, please check MMR configuration |
| `MobileRTCMeetError_PasswordError` | 4 | The meeting password is incorrect |
| `MobileRTCMeetError_SessionError` | 5 | Failed to create data connection with MMR |
| `MobileRTCMeetError_MeetingOver` | 6 | Meeting is over |
| `MobileRTCMeetError_MeetingNotStart` | 7 | Meeting is not yet started |
| `MobileRTCMeetError_MeetingNotExist` | 8 | The meeting does not exist |
| `MobileRTCMeetError_MeetingUserFull` | 9 | The amount of attendees has reached the upper limit |
| `MobileRTCMeetError_MeetingClientIncompatible` | 10 | The SDK version is incompatible |
| `MobileRTCMeetError_NoMMR` | 11 | No MMR is valid |
| `MobileRTCMeetError_MeetingLocked` | 12 | The meeting is locked by the host |
| `MobileRTCMeetError_MeetingRestricted` | 13 | The meeting is restricted |
| `MobileRTCMeetError_MeetingRestrictedJBH` | 14 | The host does not allow join before host |
| `MobileRTCMeetError_CannotEmitWebRequest` | 15 | Failed to request the web server |
| `MobileRTCMeetError_CannotStartTokenExpire` | 16 | Failed to start meeting with expired token |
| `MobileRTCMeetError_VideoError` | 17 | User's video does not work |
| `MobileRTCMeetError_AudioAutoStartError` | 18 | User's audio cannot auto-start |
| `MobileRTCMeetError_RegisterWebinarFull` | 19 | The amount of webinar attendees reaches the upper limit |
| `MobileRTCMeetError_RegisterWebinarHostRegister` | 20 | User needs to register a webinar account if he/she wants to start a webinar. |
| `MobileRTCMeetError_RegisterWebinarPanelistRegister` | 21 | User needs to register an account if he/she wants to join the webinar by the link. |
| `MobileRTCMeetError_RegisterWebinarDeniedEmail` | 22 | The host has denied your webinar registration. |
| `MobileRTCMeetError_RegisterWebinarEnforceLogin` | 23 | Sign in with the specified account to join webinar. |
| `MobileRTCMeetError_ZCCertificateChanged` | 24 | The certificate of ZC has been changed. |
| `MobileRTCMeetError_VanityNotExist` | 27 | The vanity URL does not exist. |
| `MobileRTCMeetError_JoinWebinarWithSameEmail` | 28 | The email address has already been registered in the current webinar. |
| `MobileRTCMeetError_WriteConfigFile` | 50 | Failed to write configure file |
| `MobileRTCMeetError_RemovedByHost` | 61 | Meeting is removed by the host |
| `MobileRTCMeetError_HostDisallowOutsideUserJoin` | 62 | Forbidden to join meeting. |
| `MobileRTCMeetError_InvalidArguments` | 150 | Invalid arguments |
| `MobileRTCMeetError_InAnotherMeeting` | 152 | The user joins already in another ongoing meeting |
| `MobileRTCMeetError_Failed` | 155 | API call failed. |
| `MobileRTCMeetError_VBMaximumNum` | 201 | Virtual background image reach to max capacity. |
| `MobileRTCMeetError_VBSaveImage` | 202 | Virtual background save the image error. |
| `MobileRTCMeetError_VBRemoveNone` | 203 | Virtual background save the image error. |
| `MobileRTCMeetError_VBNoSupport` | 204 | Virtual background not support. |
| `MobileRTCMeetError_VBGreenScreenNoSupport` | 205 | Virtual background GreenScreen not support, only iPad support green screen. |
| `MobileRTCMeetError_AppPrivilegeTokenError | 500 | App privilege token error. |
| `MobileRTCMeetError_Unknown` | 501 | Unknown error. Please seek help on Zoom Developer Forum. |
SDK login error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCLoginFailReason_Success` | 0 | login is successful. |
| `MobileRTCLoginFailReason_EmailLoginDisable` | 1 | Email login disabled. |
| `MobileRTCLoginFailReason_UserNotExist` | 2 | User not exist. |
| `MobileRTCLoginFailReason_WrongPassword` | 3 | Password is wrong. |
| `MobileRTCLoginFailReason_AccountLocked` | 4 | Account is locked. |
| `MobileRTCLoginFailReason_SDKNeedUpdate` | 5 | SDK need update. |
| `MobileRTCLoginFailReason_TooManyFailedAttempts` | 6 | Too many attempts. |
| `MobileRTCLoginFailReason_SMSCodeError` | 7 | SMS code error. |
| `MobileRTCLoginFailReason_SMSCodeExpired` | 8 | SMS code expired. |
| `MobileRTCLoginFailReason_PhoneNumberFormatInValid` | 9 | Phone number format invalid. |
| `MobileRTCLoginFailReason_LoginTokenInvalid` | 10 | Login token invalid. |
| `MobileRTCLoginFailReason_UserDisagreeLoginDisclaimer` | 11 | User disagrees with the login disclaimer. |
| `MobileRTCLoginFailReason_MFARequired` | 12 | Need multi-factor auth. |
| `MobileRTCLoginFailReason_NeedBirthdayAsk` | 13 | Need confirm birthday. |
| `MobileRTCLoginFailReason_OtherIssue` | 100 | Login fail other reason. |
| `MobileRTCLoginFailReason_InvalidArguments` | 101 | invalid arguements error. |
| `MobileRTCLoginFailReason_SDKNotAuthorized` | 102 | SDK not authorized error. |
| `MobileRTCLoginFailReason_InAutoLoginProcess` | 103 | Login failed for now is in auto login process. |
| `MobileRTCLoginFailReason_AlreayLoggedin` | 104 | Login failed for now is already logged in. |
Audio-related error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCAudioError_Success` | 0 | Success. |
| `MobileRTCAudioError_AudioPermissionDenied` | 1 | The application for Audio Session Recording is denied. |
| `MobileRTCAudioError_AudioNotConnected` | 2 | Do not connect to audio session. |
| `MobileRTCAudioError_CannotUnmuteMyAudio` | 3 | User can not unmute his audio. |
| `MobileRTCAudioError_Failed` | 4 | Failed. |
Video-related error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCCameraError_Success` | 0 | Success. |
| `MobileRTCCameraError_CameraPermissionDenied` | 1 | The permission to enable the camera is denied. |
| `MobileRTCCameraError_VideoNotSending` | 2 | The camera can not connect to video session. |
Claim host error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCClaimHostError_Successed` | 0 | Claim host successfully. |
| `MobileRTCClaimHostError_HostKeyError` | 1 | Host Key Errors. |
| `MobileRTCClaimHostError_NetWorkError` | 2 | Network Errors. |
Chat message error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCSendChatError_Successed` | 0 | Send chat message successfully. |
| `MobileRTCSendChatError_Failed` | 1 | Send chat message failed. |
| `MobileRTCSendChatError_PermissionDenied` | 2 | No permission. |
Annotation-related operations error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCAnnotationError_Successed` | 0 | Succeeded. |
| `MobileRTCAnnotationError_Failed` | 1 | Failed. |
| `MobileRTCAnnotationError_PermissionDenied` | 2 | No permission. |
CMR-related error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCCMRError_Successed` | 0 | |
| `MobileRTCCMRError_Failed` | 1 | Failed. |
| `MobileRTCCMRError_StorageFull` | 2 | The storage is full. |
Microphone-related error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCMicrophoneError_MicMuted` | 0 | Microphone is muted while speaking. |
| `MobileRTCMicrophoneError_FeedbackDetected` | 1 | Audio feedback is detected when join meeting. |
| `MobileRTCMicrophoneError_MicUnavailable` | 2 | Microphone is unavailable. |
Meeting end reasons error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCMeetingEndReason_SelfLeave` | 0 | User leaves meeting. |
| `MobileRTCMeetingEndReason_RemovedByHost` | 1 | The user is removed from meeting by the host. |
| `MobileRTCMeetingEndReason_EndByHost` | 2 | Host ends the meeting. |
| `MobileRTCMeetingEndReason_JBHTimeout` | 3 | Join the meeting before host (JBH) timeout. |
| `MobileRTCMeetingEndReason_FreeMeetingTimeout` | 4 | Meeting ends when the free service is over. |
| `MobileRTCMeetingEndReason_NoAteendee` | 5 | No attendee. |
| `MobileRTCMeetingEndReason_HostEndForAnotherMeeting` | 6 | Meeting ends by the host for he will start another meeting. |
| `MobileRTCMeetingEndReason_ConnectBroken` | 7 | Meeting ends for SDK disconnects, such as network issue. |
| `MobileRTCMeetingEndReason_Unknown` | 8 | Meeting ends by unknown reasons. |
Remote control operations error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCRemoteControlError_Successed` | 0 | Succeeded. |
| `MobileRTCRemoteControlError_Stop` | 1 | Remote control stopped. |
| `MobileRTCRemoteControlError_Failed` | 2 | Remote control failed. |
| `MobileRTCRemoteControlError_PermissionDenied` | 3 | No permission. |
Promoting or demoting attendee and panelist error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCWebinarPromoteorDepromoteError_Success` | 0 | Promote/demote successfully. |
| `MobileRTCWebinarPromoteorDepromoteError_Webinar_Panelist_Capacity_Exceed` | 3035 | The amount of panelist in webinar reaches the upper limit. |
| `MobileRTCWebinarPromoteorDepromoteError_Not_Found_Webinar_Attendee` | 3029 | The attendees in webinar are not found. |
Raw data error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCRawData_Success` | 0 | Operation success. |
| `MobileRTCRawData_Uninitialized` | 1 | The sdk has not been initialized.. |
| `MobileRTCRawData_Malloc_Failed` | 2 | Malloc data failed. |
| `MobileRTCRawData_Wrongusage` | 3 | Wrong usage. |
| `MobileRTCRawData_Invalid_Param` | 4 | The parameters are invalid. |
| `MobileRTCRawData_Not_In_Meeting` | 5 | The account is not in a meeting. |
| `MobileRTCRawData_No_License` | 6 | No license. |
| `MobileRTCRawData_Unknow` | 7 | Unknown error. |
| `MobileRTCRawData_Video_Module_Not_Ready` | 8 | The video module is not ready. |
| `MobileRTCRawData_Video_Module_Error` | 9 | The raw data module is not ready. |
| `MobileRTCRawData_Video_device_error` | 10 | Video device error. |
| `MobileRTCRawData_No_Video_Data` | 11 | No video data. |
| `MobileRTCRawData_Share_Module_Not_Ready` | 12 | The share module is not ready. |
| `MobileRTCRawData_Share_Module_Error` | 13 | The raw data module is not ready. |
| `MobileRTCRawData_No_Share_Data` | 14 | No share data. |
| `MobileRTCRawData_Share_Cannot_Subscribe_Myself` | 15 | Cannot subscribe to local share data. |
| `MobileRTCRawData_Audio_Module_Not_Ready` | 16 | The audio module is not ready. |
| `MobileRTCRawData_Audio_Module_Error` | 17 | The raw data module is not ready. |
| `MobileRTCRawData_No_Audio_Data` | 18 | No audio data. |
| `MobileRTCRawData_Send_Too_Frequently` | 19 | The requests are too frequent, please try again later. |
| `MobileRTCRawData_Can_Not_Change_Virtual_Device` | 20 | Cannot change virtual device. |
| `MobileRTCRawData_Not_Join_Audio` | 21 | Not join audio error. |
Breakout room error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCBOControllerError_NULL_POINTER` | 0 | Null pointer error. |
| `MobileRTCBOControllerError_WRONG_CURRENT_STATUS` | 1 | The current status is wrong. |
| `MobileRTCBOControllerError_TOKEN_NOT_READY` | 2 | The token is not ready. |
| `MobileRTCBOControllerError_NO_PRIVILEGE` | 3 | No privilege for breakour room service. |
| `MobileRTCBOControllerError_BO_LIST_IS_UPLOADING` | 4 | The breakout room list is uploading, please try again later. |
| `MobileRTCBOControllerError_UPLOAD_FAIL` | 5 | The breakout room information uploaded failed, please try again. |
| `MobileRTCBOControllerError_NO_ONE_HAS_BEEN_ASSIGNED` | 6 | Please assign at least one person to the breakout room. |
| `MobileRTCBOControllerError_UNKNOWN` | 100 | Unknown error. |
Signal error codes
| Description | Error Code | Suggestion |
|---|---|---|
| `MobileRTCANNError_Success` | 0 | Call ANN API succeed. |
| `MobileRTCANNError_NotInMeeting` | 1 | You can't call ANN api out of a meeting. |
| `MobileRTCANNError_NotCustomUI` | 2 | You should not call ANN. |
| `MobileRTCANNError_FeatureNotSupport` | 3 | ANN feature not supported. |
General error codes
Here are some common errors codes that aren't specific to our SDK, but occasionally you will see them while using our Zoom SDK.
| Description | Error Code | Suggestion |
|---|---|---|
| Failed to create a data connection with our server. | 5 | Please check your network connection or network configuration. |
| Failed to send create meeting command to our server. | 15 | Please check your network or HTTP request configuration. |
| Wrong user password | 1002 | Please check your password. |
| Web login locked out after 6 failed attempts | 1019 | Please seek support to reactivate your account |
| SDK authentication failure: invalid SDK key & secret | 3023 | Please check your SDK key & secret |
| Your account does not support using SDK | 3024 | Ensure your license type or your account has SDK enabled. |
| No response from our server in 30 seconds | 5003 | Please try again later. If it happens a lot, please visit our community forum for help. |
| DNS resolve failure | 5004 | Please check your network adaptor or your network hardware. |
| Conference does not exist | 102006 | Ensure the conference number is correct or has successfully being scheduled/hosted. |
| Zoom client version lower than the minimum required version | 102011 | Please download our latest version of SDK |
| Zoom client version higher than the maximum allowed version | 102012 | Please download our latest version of SDK |
| Conference token expired | 102014 | Get a new token from our API |
| Server is too busy | 103008 | Please try again later. If it happens a lot, please visit our community forum for help. |
| Your account does not support the requested feature | 103024 | Please ensure your account has the feature that you are requesting. |
| You account does not support call out | 103025 | Please ensure your account supports call out feature. |
| Having too much pending requests. Conference terminated | 103037 | Reduce your request frequency or try again later. |
| Your account is in blacklist | 103039 | Please seek support since your account is in the blacklist. |
| Conference going to create already exisit | 102004 / 103001 | Please try another meeting number or your previous "create meeting" request was successful. |
| Number of attendee has reached limitation | 102010 / 103006 | Contact our sales engineer if you would like to have more attendees. |
| The conference you are joining is locked | 102015 / 103011 | Please contact your meeting host to unlock the meeting. |
| Account is restricted, not allowed to join the conference | 102016 / 103014 | Your account is restricted, please seek support. |
undefined
If your error codes do not exist in the above tables, please visit our Developer Community Forum for further supports.