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.
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.
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.
Configure and save the Client
Configure the Client’s name, Role and rate limit. Then, click the “Create Client” button.
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.
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.
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.