Docs home

Live Class Meeting Join URL

Gets the link to start or join a live session (Zoom, Zoom Webinar, custom link and other platforms). Put the session's `attendance_id` (from "List of Batch Class") in the URL. A tutor calls it to start the class; a student calls it to join.

POST/liveclass/join/{attendance_id}
Live Class Meeting Join URL
curl --request POST \
  --url 'https://<your-api-host>/nuSource/api/v1/liveclass/join/{attendance_id}' \
  --header 'APIKEY: <your-api-key>' \
  --header 'ORGID: <your-org-id>'
{
  "code": 200,
  "message": "Success",
  "meeting_password": "714706",
  "join_id": "91091746832",
  "meeting_id": 436449,
  "join_url": "https://zoom.us/j/91091746832?pwd=cDdFeTZxUDJlT0VyelY1blU1UWJPUT09",
  "api_key": "UgbDGFrCTm2e1eVQuRCOwQ",
  "signature": "VWdiREdGckNUbTJlMWVWUXVSQ093US45MTA5MTc0NjgzMi4xNjc2NDU0OTM2MDAwLjAuTUh5Y0lCZkFJSU9WNFgwb0YxK2xTUUhSeGM4dXRlb3RCb1dVZndXaSt2RT0",
  "start_url": "https://zoom.us/s/91091746832?zak=eyJ0eXAiOiJKV1QiLCJzdiI6IjAwMDAwMSIsInptX3NrbSI6InptX28ybSIsImFsZyI6IkhTMjU2In0.eyJhdWQiOiJjbGllbnRzbSIsInVpZCI6IjEtM2ptNDZMVGVhcjN6cDJHTDV6UlEiLCJpc3MiOiJ3ZWIiLCJzayI6IjkxMTU3MzgxNzI5OTAwMDIyMjMiLCJzdHkiOjEwMCwid2NkIjoiYXcxIiwiY2x0IjowLCJtbnVtIjoiOTEwOTE3NDY4MzIiLCJleHAiOjE2NzY0NjIxMDAsImlhdCI6MTY3NjQ1NDkwMCwiYWlkIjoibnl6RkNQYmlTUHlWdHhZdVdDbm52USIsImNpZCI6IiJ9.3cnwSzNzxbUrl3YmUdJJiVL4Xhh_zrLLjV0h8QfX6uk",
  "user_token": "I0cyA6brI31WquSdKXzxgiTmCSB7CgcnMgjVALTqoYc.AG.cR4UWpLW6huOyvMHA2UtScj6VAdWHb7Q_-KaSLAFv92j0KrnI0ilYjWEbbbG6eyV0IGrfP3jM8QTj9yR4BVdR1BxuliGDEWBnKd58PfmGw1ExPfgOK0dP2I7G3zlghwuMbZbP5fNVrGeXAK_Snd1ih_4xA5cpRBhklonRj3acRWaoBq2DuirEtwkqeaJaxEJb_yDJ3wOxv36bsOiQjGP7l-Xabq5MSPO62DEz36_Tcx6Q8wvwjriZtle.JcWXujn5zLC07OmiMAIoAA.jnPtE73uoOulmsa5"
}

Access: Any logged-in user. What happens depends on your role:

  • Admins, tutors and custom roles get the host link (start_url). If the session hasn't started, this call starts it: the meeting is created on the session's platform if needed, the session is signed in and marked as live, and your institute's "session started" webhook is sent. For events, registered users are notified that the event has started. For mentoring sessions, only the assigned mentor can start.
  • Students get the attendee link only once the session has started ("You are not allowed to join at the moment !" before that). Joining marks the student present (unless the session uses Zoom threshold attendance). Students with a pending payment for the batch get an error whose message holds institution_bundle_id, is_free_enrolment and payment_id. Event sessions need the student to be registered ("Please register to join this event !").
Path parameters
attendance_idintegerrequired
The session (or event session) to join.
BodyJSONString
Purpose unclear from code.

A body is optional. If you send one, it is form-data with one field, JSONString, holding the JSON fields above.

Response200application/json
codeinteger
Example: 200
messagestring
Example: Success
Example: 714706
join_idstring
The Zoom meeting number
Example: 91091746832
meeting_idinteger
Example: 436449
join_urlstring
And start_url for staff
api_keystring
Example: UgbDGFrCTm2e1eVQuRCOwQ
signaturestring
start_urlstring
Staff only

Notes: Errors: "Class is already completed !" for a live session that has ended; "Cannot start cancelled class !"; "This class is live class but no meeting platform attached. Do update platform for this session" when the session has no platform set; "This mentoring session is in-person only and cannot be joined online." Treat start_url and the SDK values as secrets: they let the holder host the meeting. Rate limit: 100 requests per minute; going over locks you out for 30 minutes.

Updated yesterday

Ask AI