Create meeting bot

Create a new meeting bot to record and transcribe a meeting. Supports Zoom, Google Meet, Microsoft Teams, and Webex. The bot will join the meeting immediately or at a scheduled time.

POST /meetings

cURL

cURL - Instant

curl -X POST https://app.mavera.io/api/v1/meetings \ -H "Authorization: Bearer mvra_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "meeting_url": "https://zoom.us/j/123456789", "title": "Sales Discovery Call", "bot_name": "Mavera Notetaker" }'

201

{
  "id": "<string>",
  "object": "meeting",
  "title": "<string>",
  "meeting_url": {},
  "bot_name": "<string>",
  "join_type": "adhoc",
  "join_at": "2023-11-07T05:31:56Z",
  "status": "pending",
  "platform": "zoom",
  "workspace_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Body

application/json

meeting_url · string<uri> · required

The meeting URL to record. Supports Zoom, Google Meet, Microsoft Teams, and Webex.

title · string

Optional title for the meeting

bot_name · string · default: Mavera Notetaker

Name displayed when the bot joins the meeting

join_at · string<date-time>

Schedule the bot to join at a specific time (ISO 8601 format). If not provided or in the past, the bot joins immediately.

workspace_id · string

Workspace to associate the meeting with. Uses default workspace if not specified.

Response

201

application/json

Meeting bot created successfully

id · string

Unique meeting identifier

object · enum<string>

Available options: meeting

title · string | null

meeting_url · object

Meeting URL information

bot_name · string

join_type · enum<string>

Whether the bot joins immediately (adhoc) or at a scheduled time

Available options: adhoc, scheduled

join_at · string<date-time> | null

Scheduled join time (null for instant join)

status · enum<string>

Current status of the meeting recording

Available options: pending, joining_call, in_waiting_room, in_call_not_recording, in_call_recording, call_ended, recording_done, done, fatal, recording_permission_denied, media_expired, cancelled

platform · enum<string>

Meeting platform detected from URL

Available options: zoom, google_meet, microsoft_teams, webex

workspace_id · string

created_at · string<date-time>

updated_at · string<date-time>