Skip to main content
POST
/
v1
/
speaker-profiles
curl -X POST https://api.mavioapp.com/v1/speaker-profiles \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Alex Kim",
    "email": "alex.kim@example.com",
    "organization": "Acme Corp"
  }'

{
  "id": "spk_k1l2m3n4o5",
  "name": "Alex Kim",
  "email": "alex.kim@example.com",
  "organization": "Acme Corp",
  "meeting_count": 0,
  "total_speaking_seconds": 0,
  "last_seen_at": null,
  "created_at": "2026-04-14T09:15:00Z",
  "updated_at": "2026-04-14T09:15:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mavioapp.com/llms.txt

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

Creates a new speaker profile. Once created, Mavio uses voice embeddings and name matching to automatically associate this speaker with their segments in future meetings. You can also manually link unidentified speakers to existing profiles.
​
name
string
required
Display name for the speaker. Maximum 200 characters.
​
email
string
Optional email address. Used for matching against calendar event participants for automatic speaker identification.
​
organization
string
Optional organization or company name. Maximum 200 characters.

​
Response

​
id
string
Unique speaker profile identifier (e.g., spk_k1l2m3n4o5).
​
name
string
Display name of the speaker.
​
email
string | null
Email address, or null if not provided.
​
organization
string | null
Organization name, or null if not provided.
​
meeting_count
integer
Number of meetings (starts at 0 for new profiles).
​
total_speaking_seconds
integer
Total speaking time (starts at 0 for new profiles).
​
last_seen_at
string | null
null for newly created profiles with no meeting appearances yet.
​
created_at
string
ISO 8601 timestamp when the profile was created.
​
updated_at
string
ISO 8601 timestamp when the profile was last modified.
curl -X POST https://api.mavioapp.com/v1/speaker-profiles \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Alex Kim",
    "email": "alex.kim@example.com",
    "organization": "Acme Corp"
  }'

{
  "id": "spk_k1l2m3n4o5",
  "name": "Alex Kim",
  "email": "alex.kim@example.com",
  "organization": "Acme Corp",
  "meeting_count": 0,
  "total_speaking_seconds": 0,
  "last_seen_at": null,
  "created_at": "2026-04-14T09:15:00Z",
  "updated_at": "2026-04-14T09:15:00Z"
}