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 macOS 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 get an error code, cross-check here to see 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 .
| Description | Error Code | Suggestion |
|---|---|---|
| Success – request is successful | 0 | None |
| Network unavailable – The Zoom client engine cannot connect to the Zoom cloud. | 1 | Prompt the user to check the internal network. |
| Reconnect Failure – The Zoom stack has failed to reconnect to the meeting in case of a network error. | 2 | Leave and join the meeting again. |
| MMR error – This is an internal Zoom cloud service issue. | 3, 11 | Leave and join the meeting again. Please contact Zoom support if you receive this error repeatedly. |
| Password error – The end user password passed on to the stack is incorrect. | 4 | Prompt the user to get the right password. |
| Error in starting or joining meeting calls | 5 | None |
| Meeting has ended – If you try to start or join a meeting that has ended already. | 6 | Create another meeting. |
| Meeting has not started yet – If you try to join a meeting before host and the join before host setting is disabled. | 7 | Wait for the host to join the meeting. |
| Meeting does not exist | 8 | Check the Meeting ID. |
| Meeting is at capacity | 9 | None |
| SDK version number has been deprecated | 10 | Make sure you are running the most recent version of the MacOS stack. |
| Meeting has been locked – you are trying to join a locked meeting. | 12 | Prompt the user |
| Meeting is restricted – You are trying to join a restricted meeting. | 13 | Prompt the user |
| Join before host is restricted | 14 | None |
| Failed to send creating meeting request to the cloud | 15 | Typically a network error - please retry. |
| Client identity token has expired | 16, 17, 18 | Please contact Zoom support if you receive this error. |
| Webinar registration is at capacity – New registrations cannot be accepted. | 19 | None |
| Failed to write to config file | 50 | File system error – If you consistently receive this error please check the folder permissions. |
| Internal error codes | 100, 101 | Please contact Zoom support if you repeatedly receive this error. |
SDK error codes
| Name | Error Code | Description |
|---|---|---|
ZoomSDKError_Success | 0 | Success. |
ZoomSDKError_Failed | 1 | The action was failed. |
ZoomSDKError_Uninit | 2 | SDK is not initialized before the usage. |
ZoomSDKError_ServiceFailed | 3 | Internal service error. |
ZoomSDKError_WrongUsage | 4 | Incorrect usage of the feature. |
ZoomSDKError_InvalidParameter | 5 | Wrong parameter. |
ZoomSDKError_NoPermission | 6 | No permission. |
ZoomSDKError_NoRecordingInProgress | 7 | No recording is in process. |
ZoomSDKError_TooFrequentCall | 8 | API calls too frequently. |
ZoomSDKError_UnSupportedFeature | 9 | The current meeting doesn't support the feature. |
ZoomSDKError_EmailLoginIsDisabled | 10 | Email login is disabled. |
ZoomSDKError_ModuleLoadFail | 11 | Loading module failed. |
ZoomSDKError_NoVideoData | 12 | No video data is available. |
ZoomSDKError_NoAudioData | 13 | No audio data is available. |
ZoomSDKError_NoShareData | 14 | No share data is available. |
ZoomSDKError_NoVideoDeviceFound | 15 | No video device found. |
ZoomSDKError_DevieError | 16 | The current device has an error. |
ZoomSDKError_NotInMeeting | 17 | Currently not in a meeting. |
ZoomSDKError_initDevice | 18 | The device has not been initialized. |
ZoomSDKError_CanNotChangeVirtualDevice | 19 | Can not change the virtual device. |
ZoomSDKError_PreprocessRawdataError | 20 | Unable to pre-process the raw data. |
ZoomSDKError_NoLicense | 21 | No license to use the feature. |
ZoomSDKError_Malloc_Failed | 22 | No memory can be allocated. |
ZoomSDKError_ShareCannotSubscribeMyself | 23 | Cannot subscribe to my own sharing. |
ZoomSDKError_NeedUserConfirmRecordDisclaimer | 24 | User needs to confirm the recording disclaimer. |
ZoomSDKError_UnKnow | 25 | Unknown error. Normally this is uncommon error, please reach out to support for further assistance. |
ZoomSDKError_NotJoinAudio | 26 | Audio channel is not joined. |
ZoomSDKError_HardwareDontSupport. | 27 | SDK does not support the current device. |
Authentication error codes
| Name | Error Code | Description |
|---|---|---|
ZoomSDKAuthError_Success | 0 | Authentication is successful. |
ZoomSDKAuthError_KeyOrSecretWrong | 1 | The key or secret to authenticate is wrong. |
ZoomSDKAuthError_AccountNotSupport | 2 | The developer account does not support SDK. |
ZoomSDKAuthError_AccountNotEnableSDK | 3 | The developer account does not have SDK enabled. |
ZoomSDKAuthError_Timeout | 4 | Authentication request time out. |
ZoomSDKAuthError_NetworkIssue | 5 | Network issue. |
ZoomSDKAuthError_Client_Incompatible | 6 | This SDK version is incompatible/unsupported. Please download the latest SDK version from the Marketplace. |
ZoomSDKAuthError_JwtTokenWrong | 7 | The JWT token is invalid. |
ZoomSDKAuthError_KeyOrSecretEmpty | 8 | The key or secret to authenticate is empty. |
ZoomSDKAuthError_Unknown | 100 | Unknown error. Normally this is uncommon error, please reach out to support for further assistance. |
Login error codes
| Name | Error Code | Description |
|---|---|---|
ZoomSDKLoginFailReason_None | 0 | Initial status. |
ZoomSDKLoginFailReason_EmailLoginDisabled | 1 | Email login is disabled. |
ZoomSDKLoginFailReason_UserNotExist | 2 | User does not exist. |
ZoomSDKLoginFailReason_WrongPassword | 3 | Incorrect password. |
ZoomSDKLoginFailReason_AccountLocked | 4 | The account is locked. |
ZoomSDKLoginFailReason_SDKNeedUpdate | 5 | SDK version is unsupported. |
ZoomSDKLoginFailReason_TooManyFailedAttempts | 6 | Too many failed attempts. |
ZoomSDKLoginFailReason_SMSCodeError | 7 | SMS verification code error. |
ZoomSDKLoginFailReason_SMSCodeExpired | 8 | SMS verification code has expired. |
ZoomSDKLoginFailReason_PhoneNumberFormatInValid | 9 | Phone number format is invalid. |
ZoomSDKLoginFailReason_LoginTokenInvalid | 10 | Login token is invalid. |
ZoomSDKLoginFailReason_UserDisagreeLoginDisclaimer | 11 | User disagreed the login disclaimer. |
ZoomSDKLoginFailReason_MFARequired | 12 | Multi-Factor Authentication(MFA) is required. |
ZoomSDKLoginFailReason_NeedBirthdayAsk | 13 | Need to provide DOB information. |
ZoomSDKLoginFailReason_Other_Issue | 100 | Other issue. |
Breakout room error codes
| Name | Error Code | Description |
|---|---|---|
ZoomSDKBOControllerError_Null_Pointer | 0 | The breakout room controller is a null pointer, please make sure the SDK is initialized. |
ZoomSDKBOControllerError_Wrong_Current_Status | 1 | Incorrect current status. |
ZoomSDKBOControllerError_Token_Not_Ready | 2 | The token is not ready. |
ZoomSDKBOControllerError_No_Privilege | 3 | No privilege. |
ZoomSDKBOControllerError_BO_List_Is_Uploading | 4 | Breakout room list is uploading. |
ZoomSDKBOControllerError_Upload_Fail | 5 | Breakout room list upload was failed. |
ZoomSDKBOControllerError_No_One_Has_Been_Assigned | 6 | No user has been assigned to the BO. |
ZoomSDKBOControllerError_Unknow | 100 | Unknown error. |
Phone error codes
| Name | Error Code | Description |
|---|---|---|
PhoneFailedReason_None | 0 | Initial status. |
PhoneFailedReason_Busy | 1 | The telephone service is busy. |
PhoneFailedReason_Not_Available | 2 | The telephone service is not available. Please try again later. |
PhoneFailedReason_User_Hangup | 3 | The user hangs up. |
PhoneFailedReason_Other_Fail | 4 | Failed caused by other reasons. Please reach out to support for further assistance. |
PhoneFailedReason_No_Answer | 5 | The user you are trying to call does not answer the call. |
PhoneFailedReason_Block_No_Host | 6 | Call-out is not possible before the host joins the meeting. |
PhoneFailedReason_Block_High_Rate | 7 | Call-out is blocked due to the high cost. |
PhoneFailedReason_Block_Too_Frequent | 8 | The call is being blocked due to high call frequency. All call-in user should press number 1 to join the meeting. If multiple users do not press the button and letting the call to timeout, then the call invitation will be blocked to this meeting. |
Meeting error codes
| Name | Error Code | Description |
|---|---|---|
ZoomSDKMeetingError_Success | 0 | Started or joined the meeting successfully. |
ZoomSDKMeetingError_NetworkUnavailable | 1 | Network issue, please check the network connection. |
ZoomSDKMeetingError_ReconnectFailed | 2 | Failed to reconnect the meeting. |
ZoomSDKMeetingError_MMRError | 3 | Issue with the MMR, please try again later. |
ZoomSDKMeetingError_PasswordError | 4 | The meeting password is incorrect. |
ZoomSDKMeetingError_SessionError | 5 | Failed to create video and audio data connection with MMR. |
ZoomSDKMeetingError_MeetingOver | 6 | The meeting is over. |
ZoomSDKMeetingError_MeetingNotStart | 7 | The meeting has not started. |
ZoomSDKMeetingError_MeetingNotExist | 8 | The meeting does not exist. |
ZoomSDKMeetingError_UserFull | 9 | The total number of users reaches the upper limit of the meeting. |
ZoomSDKMeetingError_ClientIncompatible | 10 | This SDK version is incompatible or unsupported. Please download the latest SDK version from the Marketplace. |
ZoomSDKMeetingError_NoMMR | 11 | No MMR is available. |
ZoomSDKMeetingError_MeetingLocked | 12 | The meeting is locked by the host. |
ZoomSDKMeetingError_MeetingRestricted | 13 | The meeting is restricted. |
ZoomSDKMeetingError_MeetingJBHRestricted | 14 | Join Before Host is restricted. |
ZoomSDKMeetingError_EmitWebRequestFailed | 15 | Failed to request the web server. |
ZoomSDKMeetingError_StartTokenExpired | 16 | Failed to start meeting with expired token. |
ZoomSDKMeetingError_VideoSessionError | 17 | The user's video does not work. |
ZoomSDKMeetingError_AudioAutoStartError | 18 | The user's audio cannot auto-start. |
ZoomSDKMeetingError_RegisterWebinarFull | 19 | The total number of users reaches the upper limit of the webinar. |
ZoomSDKMeetingError_RegisterWebinarHostRegister | 20 | User needs to register a webinar to start the webinar as the host. |
ZoomSDKMeetingError_RegisterWebinarPanelistRegister | 21 | User needs to register a webinar to start the webinar as the panelist. |
ZoomSDKMeetingError_RegisterWebinarDeniedEmail | 22 | The host has denied your webinar registration. |
ZoomSDKMeetingError_RegisterWebinarEnforceLogin | 23 | Sign in with the specific account to join webinar. |
ZoomSDKMeetingError_ZCCertificateChanged | 24 | The certificate of the ZC has been changed. |
ZoomSDKMeetingError_vanityNotExist | 27 | The vanity conference ID does not exist. |
ZoomSDKMeetingError_joinWebinarWithSameEmail | 28 | Join webinar with the same email. |
ZoomSDKMeetingError_disallowHostMeeting | 29 | Meeting settings is not allowed to start a meeting. |
ZoomSDKMeetingError_ConfigFileWriteFailed | 50 | Failed to write configuration file. |
ZoomSDKMeetingError_forbidToJoinInternalMeeting | 60 | Joining internal meeting is not allowed. |
ZoomSDKMeetingError_RemovedByHost | 61 | User is removed from the meeting by the host. |
ZoomSDKMeetingError_HostDisallowOutsideUserJoin | 62 | Host disallows external user to join. |
ZoomSDKMeetingError_Unkown | 100 | Unknown error. |
ZoomSDKMeetingError_None | 101 | Initial status. |
ZoomSDKMeetingError_AppPrivilegeTokenError | 500 | App privilege token error. |
ZoomSDKMeetingError_JmakUserEmailNotMatch | 1143 | Jmak user email does not match. |
Talkback error codes
| Name | Error Code | Description |
|---|---|---|
ZoomSDKTalkbackError_OK | 0 | Operation successful. |
ZoomSDKTalkbackError_NoPermission | 1 | Permission denied. |
ZoomSDKTalkbackError_AlreadyExist | 2 | Object already exists. The user is already in the channel. |
ZoomSDKTalkbackError_CountOverflow | 3 | Channel count exceeds limit. |
ZoomSDKTalkbackError_NotExist | 4 | Object does not exist. |
ZoomSDKTalkbackError_Rejected | 5 | Operation rejected. |
ZoomSDKTalkbackError_Timeout | 6 | Operation timeout. |
ZoomSDKTalkbackError_Unknown | 7 | Unknown error. |
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. |