Create meeting bot

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" }'

{ "id": "<string>", "object": "meeting", "title": "<string>", "meeting_url": {}, "bot_name": "<string>", "join_at": "2023-11-07T05:31:56Z", "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

Meeting bot created successfully

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>