Customizable / programmatic employee cards on Zoom Whiteboard — supported options?

API and Webhooks
1

Programmatic / data-driven cards on Zoom Whiteboard — is the Content API a supported path?

Use case: We (enterprise account, Zoom Workplace Business) want to build an internal “employee directory” board in Zoom Whiteboard: one card per employee with our own fields — photo, name, job title, and clickable links to internal systems (Slack profile, HR system, etc.). Hundreds of cards, so manual creation/maintenance is not an option; data should come from our IdP/HR APIs and be refreshable.

What we’ve already found / tried:

  • The built-in Whiteboard card object cannot be customized (no custom fields or templates), and account-level custom attributes are admin-only — they don’t render anywhere user-facing.
  • VSDX import (POST /v2/whiteboards/files + POST /v2/whiteboards/import): the account conversion setting is enabled and a stock Visio template converts fine, but every programmatically generated .vsdx we produced (including files based on genuine Visio packages with masters/theme and master-based shapes) was silently embedded as a file attachment instead of being converted into board objects. No error, no diagnostics. The converter’s requirements appear to be undocumented, so we’ve abandoned this route.
  • The API Hub lists a Content API: GET / POST / DELETE /v2/whiteboards/{whiteboardId}/content (GetWhiteboardContent / SaveWhiteboardContent), but we can’t find any documentation of the content payload schema.

Questions:

  1. Is the Content API (POST /v2/whiteboards/{whiteboardId}/content) a supported way for customers to programmatically compose or update board objects (shapes, text, images, hyperlinks)? Is the payload schema documented anywhere?
  2. Is there any supported way to define a custom card template (own fields + hyperlinks) for Whiteboard, or is this on the roadmap?
  3. Is there a supported mechanism to update objects on an existing board programmatically (e.g., refresh employee data on a schedule) rather than recreating the board?
  4. If none of the above: what would you recommend for data-driven, clickable cards on a whiteboard — Zoom Apps for Whiteboard, or something else?