Meeting SDK usage policy
The Meeting SDK is designed for human use cases and does not support bots or AI notetakers. To build an AI notetaker application or access realtime media, use Zoom RTMS (Real-time media streams).
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. |
Anonymous join enforcement / OBF error codes
OBF token enforcement dates
- On February 7, 2026 - If you provide an OBF token, it must be valid. It must be well-formed and it must not be expired.
- On March 2, 2026 - you will not be able to join anonymously. You must provide a valid OBF token or other authenticated join method.
| Error name code number | Description | UI Message console message |
|---|---|---|
MEETING_FAIL_USER_LEVEL_TOKEN_NOT_HAVE_HOST_ZAK_OBF503 | To access meeting raw data using a privilege token, you must also provide a corresponding OBF token authorized by the meeting host. | UI message: Unable to join this meeting. This join flow is not supported, please join the meeting with a Zoom Client or contact your meeting host or vendor. Console message: To access meeting raw data using a privilege token, you must also provide a corresponding OBF token authorized by the meeting host. |
MEETING_FAIL_APP_CAN_NOT_ANONYMOUS_JOIN_MEETING504 | Anonymous joins are not allowed for this SDK app. Authenticate the Zoom user and provide a ZAK or OBF token. | UI message: Unable to join this meeting. This join flow is not supported, please join the meeting with a Zoom Client or contact your meeting host or vendor. Console message: Anonymous joins are not allowed for this SDK app. Authenticate the Zoom user and provide a ZAK or OBF token. |
MEETING_FAIL_ON_BEHALF_TOKEN_INVALID505 | The provided OBF token is invalid. Please verify that it is well-formed and has not expired. | The provided OBF token is invalid. Please verify that it is well-formed and has not expired. |
MEETING_FAIL_ON_BEHALF_TOKEN_NOT_MATCH_MEETING506 | The meeting number associated with the provided OBF token does not match the current meeting. | The meeting number associated with the provided OBF token does not match the current meeting. |
RESULT_UNKNOWN_ERROR6603 The OP block feature in production today and the new January setting for all users. | This account is blocking your Meeting SDK application. | UI message: Unable to join this meeting. Join failed because this Meeting SDK key is blocked by the host's account admin. Console message: No error message in console. |
If your error codes do not exist in the above tables, please visit our Developer Community Forum for further supports.