# Breakout rooms API

**URL:** <https://devforum.zoom.us/t/breakout-rooms-api/4255>\
**Category:** Feature Requests\
**Created:** [May 15, 2019, 3:20am UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255 "2019-05-15T03:20:06Z")\
**Posts on this page:** 20\
**Page:** 7

<div class="post-metadata">

**Author:** ![arpit.gang](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/arpit.gang/32/17366_2.png) [@arpit.gang](https://devforum.zoom.us/u/arpit.gang)\
**Post date:** [June 8, 2021, 4:47am UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/127 "2021-06-08T04:47:16Z")

</div>

+1 for Breakout Rooms API

---

<div class="post-metadata">

**Author:** ![rod.saquing](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/rod.saquing/32/26652_2.png) [@rod.saquing](https://devforum.zoom.us/u/rod.saquing)\
**Post date:** [June 8, 2021, 12:22pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/128 "2021-06-08T12:22:12Z")

</div>

+1 for this breakout rooms API.

---

<div class="post-metadata">

**Author:** ![alejandro2](https://avatars.discourse-cdn.com/v4/letter/a/8dc957/32.png) [@alejandro2](https://devforum.zoom.us/u/alejandro2)\
**Post date:** [June 11, 2021, 9:14pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/129 "2021-06-11T21:14:16Z")

</div>

+1 for the Breakout Rooms API from the [SchoolBox Team](https://goschoolbox.com/).

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [June 15, 2021, 3:41pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/130 "2021-06-15T15:41:01Z")

</div>

Hey everyone,

With the [Create](https://marketplace.zoom.us/docs/api-reference/zoom-api/meetings/meetingcreate), [Update](https://marketplace.zoom.us/docs/api-reference/zoom-api/meetings/meetingupdate), and [Get](https://marketplace.zoom.us/docs/api-reference/zoom-api/meetings/meeting) Meeting APIs, you can manage and pre assign breakout rooms:

 ![image](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/6/d/6d36945a7c2618a926aaffda8d93ca873cbb6d06.png)

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![pikonferans](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/pikonferans/32/6433_2.png) [@pikonferans](https://devforum.zoom.us/u/pikonferans)\
**Post date:** [June 16, 2021, 1:01pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/131 "2021-06-16T13:01:25Z")

</div>

This is not a solution.  
This is not an API.  
This is typical Zoom coming up for a half-baked thing!? for a valid feature requested by hundreds of pro users.  
Just like they did with the multiple spotlight feature.  
Just like they **will do** with the NDI feature.

We already could upload a csv to the web portal before this (solution?!).  
How much of an improvement is it to do the same thing via a _patch_ request instead of manually uploading?  
Is this what you came up with for over a year?

How is this an API if I, as the host, still have **close the rooms** and return 150 participants in 15 rooms to the main hall just to shuffle them to their new rooms or still click to those damn hover-to-reveal buttons to change their rooms???

It’s a real shame that you don’t have any competition in this field. Yes, I admit that Zoom is still the best and we must use it and believe me you hardly deserve this level of success.

I’m 100% sure that the same half-baked solution-like thing will be what you’ll do with the much-waited **NDI** feature.

I’m so frustrated, we were waiting for a whole year for the heavens’ sake, I’m so … 🤦🏻‍♂️ 😕

~ Fatih

---

<div class="post-metadata">

**Author:** ![ssaunier](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/ssaunier/32/18842_2.png) [@ssaunier](https://devforum.zoom.us/u/ssaunier)\
**Post date:** [June 16, 2021, 7:52pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/132 "2021-06-16T19:52:13Z")

</div>

Hello @tommy,

Thanks for finally getting back to us! That’s definitely progress, let’s be happy about that. Still the API as is i unsable, for at least two reasons on my side (but I’m sure other people might have their 2 cents here, we are many here!)

## Unpredictable order

Here’s the Ruby code I just used to fill the `breakout_room` parameter:

```ruby
{
  enable: true,
  rooms: [
    { name: "Table 1", participants: [] },
    { name: "Table 2", participants: [] },
    { name: "Table 3", participants: [] },
    { name: "Table 4", participants: [] },
    { name: "Table 5", participants: [] }
  ]
}

```

And here is a screenshot of the breakout rooms I get when I join the meeting:

 ![Screenshot 2021-06-16 at 21.49.50](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/4/1/41c253b65c4836dacd6a5ad6e1c3202fb7077811.jpeg)

Quite confusing for our students!

## Limited options

Creating the breakout rooms with the API gives us the following default options:

 ![Screenshot 2021-06-16 at 21.50.50](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/5/c/5c270415895d5e8d103bd94ca8799d80bc56916e.png)

In our case, we would like to have the “Allow participants to choose room” **ticked** by default! This is not mentionned in the API, I guess we could extend the `breakout_room` JSON we send back to you with a few more booleans.

Hope this thread does not get marked as “Solved” on your end and you can continue improve the API with our feedback! Thank you!

---

<div class="post-metadata">

**Author:** ![kunal](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/kunal/32/4298_2.png) [@kunal](https://devforum.zoom.us/u/kunal)\
**Post date:** [June 25, 2021, 3:43am UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/133 "2021-06-25T03:43:00Z")

</div>

Looks like there is a bug, please look at following post

> [@Uploading breakout room CSV is not working for the meeting created using API](https://devforum.zoom.us/t/uploading-breakout-room-csv-is-not-working-for-the-meeting-created-using-api/53126):
>
> Uploading breakout room CVS for meetings created using API is not working Description When we create a meeting using API and try to upload CSV using the website it’s not saving the breakout room. Error no error Which App Type (OAuth & JWT )? Using JWT token to create the meeting Which Endpoint/s? Created meeting using /users/{userId}/meetings How To Reproduce (If applicable) Steps to reproduce the behavior: Created meeting using API (/users/{userId}/meetings) Generated CSV for the b…

---

<div class="post-metadata">

**Author:** ![LisaC](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/lisac/32/29679_2.png) [@LisaC](https://devforum.zoom.us/u/LisaC)\
**Post date:** [August 1, 2021, 6:40pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/134 "2021-08-01T18:40:20Z")

</div>

+1 on a Breakout Room API

---

<div class="post-metadata">

**Author:** ![matt.herron](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/matt.herron/32/29821_2.png) [@matt.herron](https://devforum.zoom.us/u/matt.herron)\
**Post date:** [August 5, 2021, 2:25pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/135 "2021-08-05T14:25:34Z")

</div>

Definitely needing the Breakout room API +1

---

<div class="post-metadata">

**Author:** ![laurex](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/laurex/32/30622_2.png) [@laurex](https://devforum.zoom.us/u/laurex)\
**Post date:** [August 31, 2021, 1:04am UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/136 "2021-08-31T01:04:09Z")

</div>

Another request for Breakout Room API. In my case, one additional wish would be to be able to GET which users were present in which breakout room (since when we upload the list pre-meeting, some people may not have actually joined the meeting, and if we assign random breakouts, we would like to know who was in each group later).

---

<div class="post-metadata">

**Author:** ![shollingsworth](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/shollingsworth/32/30688_2.png) [@shollingsworth](https://devforum.zoom.us/u/shollingsworth)\
**Post date:** [September 1, 2021, 11:00pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/137 "2021-09-01T23:00:28Z")

</div>

+1 for the API request for Breakout rooms

---

<div class="post-metadata">

**Author:** ![Septatrix](https://avatars.discourse-cdn.com/v4/letter/s/c68b51/32.png) [@Septatrix](https://devforum.zoom.us/u/Septatrix)\
**Post date:** [September 30, 2021, 6:16pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/138 "2021-09-30T18:16:55Z")

</div>

The response marked as a solution is also not sufficient for our use case. Our use cases are oral exams in education and we are unable to preassign breakout because:

1. We do not know either the email nor the id of the students in advance (due to privacy)
2. The breakout rooms are ephemeral but the sum of all breakout rooms during the meetings lifetime surpasses 50

While we are able to get the ids while the meeting is in progress we are unable to put the participants in new breakout rooms.

---

<div class="post-metadata">

**Author:** ![Septatrix](https://avatars.discourse-cdn.com/v4/letter/s/c68b51/32.png) [@Septatrix](https://devforum.zoom.us/u/Septatrix)\
**Post date:** [October 8, 2021, 9:33pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/139 "2021-10-08T21:33:11Z")

</div>

@tommy Should I open a new issue given that this one is marked as solved?

---

<div class="post-metadata">

**Author:** ![Mattbenji](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/mattbenji/32/31983_2.png) [@Mattbenji](https://devforum.zoom.us/u/Mattbenji)\
**Post date:** [October 18, 2021, 2:13pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/140 "2021-10-18T14:13:42Z")

</div>

@tommy Another +1 for a complete breakout room API.

---

<div class="post-metadata">

**Author:** ![MikeHenley](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/mikehenley/32/32068_2.png) [@MikeHenley](https://devforum.zoom.us/u/MikeHenley)\
**Post date:** [October 21, 2021, 3:06pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/141 "2021-10-21T15:06:05Z")

</div>

Our company would really like access to a breakout room api, but mainly to overcome current shortcomings with the client. If we could choose to have breakout rooms and self-assignment enabled automatically it would completely solve our client issues.

We have a single daily re-occurring meeting that we’ve assigned multiple breakout rooms for standups. We do this because a decent amount of people jump between them as different standups occur. Keeping them organized in one meeting has been awesome, but this also means someone has to open the rooms and allow self-assignment daily. We keep throwing more co-hosts at the problem as who logs in to open them seems to change day by day, but a client update or an api so an app can fix it for us would be better.

---

<div class="post-metadata">

**Author:** ![Bill.Hyde](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/bill.hyde/32/32296_2.png) [@Bill.Hyde](https://devforum.zoom.us/u/Bill.Hyde)\
**Post date:** [October 30, 2021, 5:37am UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/142 "2021-10-30T05:37:32Z")

</div>

+1 here for Breakout Rooms API. We need to be able to dynamically assign participants without zoom accounts to a breakout room based on information collected during our custom authentication, registration, and check-in process. Any person in a roughly 90,000 person set may join the meeting. We expect about 5,000 (but we don’t know which 5,000) to be divided up into about 250 breakout rooms according to their registration record data. Registrations can happen after the meeting has started.

---

<div class="post-metadata">

**Author:** ![zoomer11](https://avatars.discourse-cdn.com/v4/letter/z/ac8455/32.png) [@zoomer11](https://devforum.zoom.us/u/zoomer11)\
**Post date:** [December 23, 2021, 2:15pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/143 "2021-12-23T14:15:13Z")

</div>

+1 for zoom breakout rooms

---

<div class="post-metadata">

**Author:** ![believr](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/believr/32/34327_2.png) [@believr](https://devforum.zoom.us/u/believr)\
**Post date:** [January 21, 2022, 6:00am UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/144 "2022-01-21T06:00:28Z")

</div>

+1 for a FULL robust breakout rooms api.

Really I just want to be able to assign and move people via API.

Or make the randomize feature better - I want to use it as an ice breaker where folx will be matched with someone random multiple times.

---

<div class="post-metadata">

**Author:** ![dturanski](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/dturanski/32/34784_2.png) [@dturanski](https://devforum.zoom.us/u/dturanski)\
**Post date:** [February 3, 2022, 8:20pm UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/145 "2022-02-03T20:20:07Z")

</div>

Definitely a useful feature. Following…

---

<div class="post-metadata">

**Author:** ![janelletavares](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/janelletavares/32/40389_2.png) [@janelletavares](https://devforum.zoom.us/u/janelletavares)\
**Post date:** [August 11, 2022, 1:49am UTC](https://devforum.zoom.us/t/breakout-rooms-api/4255/147 "2022-08-11T01:49:58Z")

</div>

+1 for Breakout Rooms API. my use case has been mentioned already

[Previous page](https://devforum.zoom.us/t/breakout-rooms-api/4255.md?page=6)

[Next page](https://devforum.zoom.us/t/breakout-rooms-api/4255.md?page=8)
