Docs home

Zoom Class Join

Joins a live Zoom class from a student app. Put the session's `attendance_id` in the URL. The response has the Zoom link plus the values needed to open the meeting inside your app with the Zoom SDK.

POST/liveclass/join/{attendanceId}
Zoom Class Join
curl --request POST \
  --url 'https://<your-api-host>/nuSource/api/v1/liveclass/join/{attendanceId}' \
  --header 'APIKEY: <your-api-key>' \
  --header 'ORGID: <your-org-id>'
{
  "code": 200,
  "message": "Success",
  "meeting_password": "90453",
  "join_id": "96963361715",
  "meeting_id": 21608,
  "join_url": "https://zoom.us/j/96963361715?pwd=YnYwTExvN3k5aDIzb3JXTlN4UmpZQT09",
  "api_key": "XVFofTU2SGGJFvfWdVhZBA",
  "sdk_key": "TOyF5J5EIYDEbSaIoh7ipOEnrnxadgx7TmSS",
  "sdk_jwt_key": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhcHBLZXkiOiJUT3lGNUo1RUlZREViU2FJb2g3aXBPRW5ybnhhZGd4N1RtU1MiLCJpYXQiOjE3MDkxODQ5NzgsImV4cCI6MTcwOTE4ODU3OCwidG9rZW5FeHAiOjE3MDkxODg1Nzh9.gLtbPuHoutvU8z0RG7zUfzfr5apB3h1e7-4BPmAeBLY",
  "signature": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZGtLZXkiOiJUT3lGNUo1RUlZREViU2FJb2g3aXBPRW5ybnhhZGd4N1RtU1MiLCJtbiI6Ijk2OTYzMzYxNzE1Iiwicm9sZSI6MCwiaWF0IjoxNzA5MTg0OTc4LCJleHAiOjE3MDkxODg1NzgsInRva2VuRXhwIjoxNzA5MTg4NTc4fQ.dWKX_5Z1QHQlPvHDhaJNClis2amWCei1zsYdeicLT3c"
}

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: 90453
join_idstring
The Zoom meeting number
Example: 96963361715
meeting_idinteger
Example: 21608
join_urlstring
And start_url for staff
api_keystring
Example: XVFofTU2SGGJFvfWdVhZBA
sdk_keystring
Example: TOyF5J5EIYDEbSaIoh7ipOEnrnxadgx7TmSS
signaturestring

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