Setting the file. One moment. Common Issues · Zoom Apps SDK · anthropics/knowledge-work-plugins · Skills Docs
Quick diagnostics for Zoom Apps SDK problems.
22
Validate Data
Tech Debt
62
Recruiting Pipeline
71
Vendor Check
125
Zoom Meeting SDK Web
88
Vendor Review
181
Create An Asset
Video Sdk/web
| App shows blank panel | Domain not in allowlist | Marketplace > Feature > Add Allow List > add your domain |
zoomSdk is not defined | SDK script not loaded | Add <script src="https://appssdk.zoom.us/sdk.js"></script> |
SyntaxError: redeclaration of non-configurable global property | Declared let zoomSdk | Use let sdk = window.zoomSdk instead |
config() throws error | Not running in Zoom client | Wrap in try/catch, show browser fallback UI |
config() hangs forever | SDK not initialized | Add 3-second timeout fallback |
| API call fails silently | Missing OAuth scope | Add required scopes in Marketplace > Scopes tab |
authorize() doesn’t work | Wrong OAuth flow | Use In-Client OAuth: authorize() + onAuthorized |
postMessage not received | Instances not connected | Call connect() first, wait for onConnect |
runRenderingContext fails | Missing capability | Add 'runRenderingContext' to config() capabilities |
| App works then stops | Tunnel URL changed (ngrok/cloudflared/etc.) | Update every Marketplace URL that points at your tunnel domain (home page, redirect URLs, etc.) |
| CORS errors | Backend URL mismatch | Ensure frontend fetches from same-origin or configure CORS |
| Cookies not persisting | Wrong cookie settings | Set sameSite: 'none', secure: true |
| OAuth token exchange 400 | Wrong redirect URI | Ensure redirect URI matches exactly in Marketplace and code |
| 403 from Zoom REST API | Token expired | Implement token refresh with refresh_token |
| App loads in browser but not in Zoom | CSP headers wrong | Add frame-ancestors 'self' zoom.us *.zoom.us |
unsupportedApis contains your API | Old Zoom client | User needs to update Zoom client |
| Collaborate/Layers APIs missing | Host privileges or client/version mismatch | Check unsupportedApis + clientVersion; ensure required features enabled in Marketplace; test as meeting host where required |
| drawImage fails in camera mode | CEF not ready | Add retry with exponential backoff (see camera-mode example) |
Common SDK error codes from config() and API calls:
troubleshooting/common-issues.md