You are viewing the API documentation for BigBlueButton 3.x. The current version is BigBlueButton 4.x. Planning an upgrade? The migration guide lists every change your API calls need.
bbbserver.de IntegrationAPI
The IntegrationAPI on bbbserver.de is a proxy that mirrors the standard BigBlueButton API while distributing conferences across multiple servers with sufficient capacity in the background.
bbbserver.de is an EU-based premium hosting platform for BigBlueButton with servers located in the EU. External applications connect via the familiar BBB API and behave as if they were talking to a single server.
Where to Find API URL and Shared Secret
Your API URL and shared secret are available in the bbbserver admin panel under Integrations & API → Integration API. The IntegrationAPI can also be enabled or disabled there.
You do not need shell access or bbb-conf commands to retrieve credentials when using bbbserver.de.
Plugin Compatibility
The following platforms work out of the box. In most cases, you only need to enter the API URL and shared secret into the standard BigBlueButton integration.
- Moodle (BigBlueButtonBN)
- ILIAS
- Nextcloud
- WordPress
- Greenlight
Differences from the Standard API
The IntegrationAPI mirrors the standard BBB API closely, but several behaviors on bbbserver.de are different enough that they should be understood explicitly during integration.
Capacity Reservation
When you create a conference through the IntegrationAPI, bbbserver.de must assign it to a backend server with enough remaining resources. This is why maxParticipants and duration act as a reservation request for connection and runtime capacity rather than merely documenting expected usage.
Both values should therefore be provided on create calls. If they are omitted, the defaults from Integrations & API → Integration API are used.
Capacity Reservation Example
The following example shows how reservation-based capacity planning changes the behavior compared to a normal single-server assumption:
| Situation | Effect on Capacity |
|---|---|
| Your account allows 20 concurrent connections | This is the total connection pool available for active reservations. |
Conference A is created with maxParticipants = 15 and duration = 120 minutes | Conference A reserves 15 of the 20 available connections for the full two-hour reservation window. |
| Another conference is created during those two hours | It cannot reserve more than the 5 remaining connections while conference A is still inside its reserved time window. |
| The two hours are over and conference A is still running | Conference A may continue, but its reserved capacity is no longer guaranteed or protected. |
Conference B is later created with maxParticipants = 10 | The system may automatically terminate conference A in favor of conference B because conference A is no longer protected by an active reservation. |
Behavior of parameter "duration"
On bbbserver.de, duration is part of capacity planning. The meeting does not end exactly when the configured time is exceeded. Instead, bbbserver.de ends a meeting automatically in the following cases:
- 10 minutes after the planned end time, if no participant is connected anymore.
- For trial subscriptions: at the planned end time.
- At the latest 24 hours after the start.
- When the capacity is needed for another meeting and the meeting is no longer protected by its reservation (see the example above).
If your workflow requires a fixed end time, schedule an explicit end API call.
Additional Parameter for White-labeling
deactivateBbbserverDefaultChatTexts accepts true or false and defaults to false.
While it remains false, bbbserver.de places its own text in front of your welcome text: a link to bbbserver.de, dial-in instructions and a hosting notice. Moderators additionally see a text with the maximum number of participants, the planned time window and a note that the meeting may be ended when the capacity is needed. Set the parameter to true if you want to disable these default texts for white-labeling.
The default texts can also be hidden in the customer settings. In that case the moderator text is always omitted, and the welcome text is omitted if you pass your own welcome text.
Unavailable Endpoints
The following API calls exist in the standard API, but are not implemented by the IntegrationAPI:
getJoinUrl, sendChatMessage, updateRecordings, getRecordingTextTracks, putRecordingTextTrack, hooks/ping
Unpublished Recordings
If you unpublish a recording, it is shown as unpublished in the API and external services process it accordingly. However, the recording itself can still be opened if the playback link is known.
Webhooks
Hooks must be registered for specific meeting IDs. Registration for all meetings without specifying a meeting ID is not supported.
Webhook events are filtered before they are forwarded: only selected fields are passed on. Participant data such as the name, external-user-id, user agent and userdata parameters are included in plain text. All other fields, such as participant IP addresses, chat messages and poll data, are removed.
Rate Limits
There are no rate limits on the IntegrationAPI.
In addition to the IntegrationAPI, bbbserver.de offers a separate System API with platform-specific features such as account management and usage statistics. The System API is not BBB-compatible and is not covered in this guide.
Frequently Asked Questions
maxParticipants and duration reserve capacity, meetings do not end exactly at the configured duration, deactivateBbbserverDefaultChatTexts controls platform chat texts, some endpoints are unavailable, and webhooks are meeting-specific.getMeetingInfo, insertDocument and hooks/list. The request log lets you test the API itself, test your own integration, and inspect how the API behaves in practice.