Pre-Requisites

Welcome to the MeetBit Public API documentation

To begin using the MeetBit Public API, you must generate Access Keys in the MeetBit Admin Panel and familiarize yourself with a few concepts.

Generate Access keys

MeetBit uses Clients as the basis for communicating with the Public API. Follow the instructions below to create a Client and generate its Access Keys.

You must be from the Global Department and have the permissions to create Clients (clients.create.*) and create Access Keys (access_keys.create.*) before moving forward.

1. Create a Role for the Client

   Create a new Role for the Client to adopt and grant it with the necessary permissions. Follow the instructions indicated in Roles.

2. Open the Create Client Page

   Head over to https://customdomain.com/admin/clients/create to open the Create Client Page. This can also be accessed from the Clients Page and clicking the “Create Client” button on the upper right corner of the page.

3. Configure and save the Client

   Configure the Client’s name, Role and rate limit. Then, click the “Create Client” button.

4. Generate Access Key

   After being redirected to the new Client’s page, scroll down to “Access Keys” and click the ”+” icon. Then, click “Yes, generate” on the confirmation dialog.

5. Save Access Key

   Once the new Access Key ID and secret are visible, immediately copy and save the pair somewhere else. The Access Key Secret will not be visible again after this step.

   Never save the Access Key ID and Secret in code. We recommend using environment variables for this.

6. Use Access Key

   Your newly generated Access Key, may now be used to authenticate with the MeetBit Public API. Follow the instructions in Authentication & Authorization for more information.

Naming Differences

There are a few differences between the naming of resources in MeetBit’s Graphical User Interface (GUI) and the MeetBit Public API.

These are mainly due to user experience decisions made to make the platform easier to understand and use for non-technical people. The MeetBit Public API does not reflect these changes and stay close to how data is actually stored and processed.

The differences are indicated in the table below:

MeetBit GUI Name	MeetBit Public API Name	Description
Workspace	Tenant	The resource object that represents the actual client.
Conference Room	Online Conference	The resource object that represents an online call.
Conference Room Attendee	Online Conference Attendee	The resource object that represents an attendee of an online call.

Base URL

Since the MeetBit Platform always has custom domains for tenants to use, there is no static base URL to use when communicating with the MeetBit Public API. Thus, the format for the base URL is as follows:

https://{primary_domain}/api/public/v2.0

Take note that you can only use the primary domain of your tenant to communicate with the MeetBit Public API. Using alternative domains will result in a 404 Not Found error to be returned.