PUT/api/v1/zoom/connection

Connect 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).

API token required20 per minute per IP

Guide: Zoom

Code samples and Try it

Request body

#

application/json, required

  • workspace_idstringRequired

    Matches ^[0-9a-f]{24}$.

  • account_idstringRequired

    1–128 characters.

  • client_idstringRequired

    1–128 characters.

  • client_secretstring

    Blank: keep the saved one. Up to 256 characters.

  • secret_tokenstring

    The event subscription's Secret Token. Blank: keep the saved one. Up to 256 characters.

  • team_idstring

    Matches ^([0-9a-f]{24})?$.

Responses

#
  • 200OK.
  • 401No token, or the token is revoked or mistyped.
  • 422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
  • 429Too many requests from your IP address. Wait the seconds in Retry-After.
Did this page help?