Skip to main content
POST
/
api
/
run
/
meetings
/
lifecycle
/
createMeeting
createMeeting
curl --request POST \
  --url https://connvo-dev.convex.cloud/api/run/meetings/lifecycle/createMeeting \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "args": {
    "title": "Quarterly Planning Meeting",
    "description": "Planning the roadmap for next quarter objectives.",
    "scheduledAt": 1704067200000,
    "duration": 3600,
    "participantEmails": [
      "host@example.com",
      "participant@example.com"
    ],
    "recordingEnabled": false,
    "transcriptionEnabled": true,
    "meetingType": "small-group",
    "maxParticipants": 8
  }
}'
{
  "status": "success",
  "errorMessage": "",
  "errorData": {},
  "value": {
    "meetingId": "meeting_123example",
    "webrtcReady": true,
    "videoProvider": "webrtc",
    "features": {
      "recording": false,
      "transcription": true,
      "maxParticipants": 8
    }
  }
}

Authorizations

Authorization
string
header
required

Standard user authentication token issued via WorkOS. Provide as Authorization: Bearer <user-token>.

Body

application/json
args
object
required

Response

Convex executed your request and returned a result

status
enum<string>
required
Available options:
success,
error
errorMessage
string
errorData
object
value
object