/api/v1/zoom/connectionConnect Zoom (your own app)
Saves the workspace's Zoom Server-to-Server OAuth app: account_id, client_id, client_secret and secret_token (the event subscription's Secret Token; leave either secret out to keep the saved one), and optionally team_id. Markdrop checks them with Zoom first (an access token and a test call) and stores the secrets encrypted. Admins and owners. 400 when Zoom refuses the credentials; 409 when that Zoom account is connected to another workspace, or the workspace is connected with the Markdrop app for Zoom (disconnect it first).
Guide: Zoom
Code samples and Try itRequest body
#application/json, required
workspace_idstringRequiredMatches
^[0-9a-f]{24}$.account_idstringRequired1–128 characters.
client_idstringRequired1–128 characters.
client_secretstringBlank: keep the saved one. Up to 256 characters.
secret_tokenstringThe event subscription's Secret Token. Blank: keep the saved one. Up to 256 characters.
team_idstringMatches
^([0-9a-f]{24})?$.
Responses
#200OK.401No token, or the token is revoked or mistyped.422The request didn't validate.detaillists each problem, with where it is (loc) and why (msg).429Too many requests from your IP address. Wait the seconds inRetry-After.