Skip to main content
POST
/
meetings
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_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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mavera.io/llms.txt

Use this file to discover all available pages before exploring further.

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

​
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>