POST/api/v1/zoom/connect/finish

Finish connecting Zoom

Called by the page Zoom returns to, with Zoom's code and either the state from Start connecting (the workspace is in it) or, for an install started in the Zoom App Marketplace, the workspace_id to connect (and optionally team_id). Markdrop exchanges the code, finds the Zoom account and stores the tokens encrypted; the response is the connection status plus workspace_id. Admins and owners. 400 when the link expired or was used; 409 when that Zoom account is connected to another workspace.

API token required20 per minute per IP

Guide: Zoom

Code samples and Try it

Request body

#

application/json, required

  • codestringRequired

    1–2,000 characters.

  • statestring

    From Markdrop's Connect Zoom; absent for installs started in the Zoom App Marketplace. Up to 1,000 characters.

  • workspace_idstring

    Without a state: the workspace to connect (admins). Matches ^[0-9a-f]{24}$.

  • 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?