Breakout Room Token Expiration Issue – SDK Not Refreshing 15-Min Token

Hi everyone,

Hi everyone,

We’re experiencing a consistent and reproducible issue with the Zoom Meeting SDK (Web, embedded client) related to breakout rooms and token expiration.

Setup:

  • We initialize the SDK using a JWT token with a 2-hour validity.
  • SDK version: latest available via NPM (we are always using the most up-to-date release).
  • The meeting starts and runs smoothly — users can join and interact in the main session.

The Problem:

  • When a user is assigned to a breakout room, the SDK internally generates a new token, but this one only lasts 15 minutes.
  • Once this token expires, the SDK does not refresh it automatically, nor does it allow us to manually update it “on the fly” (as confirmed by Zoom support).
  • When the host/admin tries to bring users back from the breakout room after the 15 minutes have passed, they receive an error and are disconnected or stuck.

Error Message:

Joining Meeting Timeout or Browser Restriction

Technical Details:

  • The issue is 100% reproducible, not intermittent.
  • Inspecting the browser’s Network tab, we observed the refresh_token endpoint being hit multiple times (around 5) once the user is pulled from the breakout room.
  • However, since the internal token is already expired, the SDK fails to refresh it and throws the error.
  • This maybe suggests the problem is within the SDK’s token management, not in the implementation.

Is anyone else facing this issue or found a way to handle token renewal properly in breakout rooms?

Any help or acknowledgment would be appreciated. Thanks!

Hi @ryandgs
Thanks for sharing this with us.
I will try and replicate this issue on my end and will update you with my findings

1 Like

Hi @elisa.zoom,

Just following up on this thread. I’m actively working on this integration and wanted to check if there have been any updates or findings regarding the breakout room token expiration issue.
Really appreciate your support! :pray:

Hey @ryandgs
Thanks for your patience here!
I was out for a couple of days and could not get back to you
I don’t fully understand the issue you are having.
Would you be able to record this issue? have you been able to replicate it in with our sample app? GitHub - zoom/meetingsdk-web-sample: Zoom Meeting SDK web sample

I tried replicating the issue with this sample app but I was not able to

Hi @elisa.zoom!

Here’s how to reproduce it:

Step 1: As host, create a breakout room
Step 2: Assign a participant to it
Step 3: As the participant, join the breakout room
At this point, the SDK will call zoom.us/refresh_tokens and will generate a 15min token
Step 4: Wait 15+ min for the token to expire
Step 5: As host, close the breakout room
Step 6: As the participant, try to go back to the main room
Step 7: Error

Hope this helps!

(I’m trying to post a link to a gif showing the steps above but it’s not letting me)
https:// drive . google . com/file/d/1Nhak8Bt7NETlkWsBB8oxfJdqD3tQjz5Z/view?usp=sharing

Hi @Dalton
I will send you a DM so you can share the gif with me please

1 Like

Hi @elisa.zoom ,

Just wanted to check if there are any updates in the meantime. Thanks!! :smiley:

Hey @ryandgs
I sent @Dalton a DM last night with more guidance/questions

Hi again @elisa.zoom :smiley:

Dalton is on vacation for a few days. Could you please update me? So feel free to forward anything relevant to me in the meantime.
Thanks!

Yes! let me send you a DM

1 Like

Hello, issue resolved in release 4.0.5. Thank you so much for all the support! :smile:

1 Like

Thank you for your patience and for confirming that this issue was resolved on your end.