Create Zoom OAuth Connection

Exchange the code from Zoom’s redirect for a stored connection. Call this from your server when your redirect URI receives ?code=...&state=.... Save the returned zoom_user_id against your end-user record - you pass it back on create_bot as zoom.zoom_oauth_connection_user_id.

Authentication

AuthorizationToken

Format: Token <your_api_key>

Request

This endpoint expects an object.

codestringRequired

The authorization code from Zoom's redirect to your callback

redirect_uristringRequired

The exact same redirect URL registered on your Zoom app and used on authorize-url

metadatamap from strings to stringsOptional

Your own key/values to store with the connection (e.g. tenant_user_id)

Response

Connection stored

zoom_user_idstringOptional

The end-user’s Zoom user ID - pass as zoom.zoom_oauth_connection_user_id on create_bot

zoom_account_idstringOptional

emailstringOptional

display_namestringOptional

metadatamap from strings to stringsOptional

statestringOptional

created_atstringOptional

updated_atstringOptional

has_refresh_tokenbooleanOptional

$	curl -X POST https://api.meetstream.ai/api/v1/zoom/oauth/connections \
>	-H "Authorization: Token <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"code": "<from Zoom redirect>",
>	"redirect_uri": "https://yourapp.example.com/zoom/oauth/callback",
>	"metadata": {
>	"tenant_user_id": "alice-internal-uuid"
>	}
>	}'

1	{
2	"zoom_user_id": "string",
3	"zoom_account_id": "string",
4	"email": "string",
5	"display_name": "string",
6	"metadata": {},
7	"state": "connected",
8	"created_at": "string",
9	"updated_at": "string",
10	"has_refresh_token": true
11	}