POST
/
v1
/
meetings
/
{id}
/
share
curl -X POST https://api.mavioapp.com/v1/meetings/mtg_8f3k2j1m4n5p/share \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "recipients": ["alex@example.com", "jordan@example.com"],
    "permission": "comment",
    "generate_link": true,
    "message": "Here are the notes from our product sync."
  }'

{
  "id": "shr_k1l2m3n4o5",
  "meeting_id": "mtg_8f3k2j1m4n5p",
  "permission": "comment",
  "recipients": [
    {
      "email": "alex@example.com",
      "status": "sent",
      "invited_at": "2026-04-14T09:30:00Z"
    },
    {
      "email": "jordan@example.com",
      "status": "sent",
      "invited_at": "2026-04-14T09:30:00Z"
    }
  ],
  "link": {
    "url": "https://app.mavioapp.com/shared/mtg_8f3k2j1m4n5p?token=shr_tok_x9y8z7w6",
    "expires_at": null
  },
  "created_at": "2026-04-14T09:30:00Z"
}
Shares a meeting with one or more recipients by email, or generates a shareable link with configurable permissions. Recipients receive an email notification with a link to the meeting. You can also generate a public or restricted link without specifying recipients.
​
id
string
required
The unique meeting identifier (e.g., mtg_8f3k2j1m4n5p).
​
recipients
array
List of email addresses to share the meeting with. Each recipient receives an email invitation. Maximum 50 recipients per request.
​
permission
string
default:"view"
Permission level granted to recipients. One of view (read-only access to transcript, summary, and recording), comment (view plus ability to add comments and notes), or edit (full access including editing summary and action items).
​
generate_link
boolean
default:"false"
When true, generates a shareable link that can be distributed independently of the recipient list. The link inherits the specified permission level.
​
message
string
Optional personal message to include in the email notification sent to recipients. Maximum 500 characters.
​
expires_at
string
Optional expiration date for the share link in ISO 8601 format. After this time, the link becomes invalid. Only applies when generate_link is true.

​
Response

​
id
string
Unique share identifier (e.g., shr_k1l2m3n4o5).
​
meeting_id
string
The ID of the shared meeting.
​
permission
string
The permission level granted: view, comment, or edit.
​
recipients
array
List of recipients and their invitation status.
​
link
object | null
The generated share link, or null if generate_link was false.
​
created_at
string
ISO 8601 timestamp when the share was created.
curl -X POST https://api.mavioapp.com/v1/meetings/mtg_8f3k2j1m4n5p/share \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "recipients": ["alex@example.com", "jordan@example.com"],
    "permission": "comment",
    "generate_link": true,
    "message": "Here are the notes from our product sync."
  }'

{
  "id": "shr_k1l2m3n4o5",
  "meeting_id": "mtg_8f3k2j1m4n5p",
  "permission": "comment",
  "recipients": [
    {
      "email": "alex@example.com",
      "status": "sent",
      "invited_at": "2026-04-14T09:30:00Z"
    },
    {
      "email": "jordan@example.com",
      "status": "sent",
      "invited_at": "2026-04-14T09:30:00Z"
    }
  ],
  "link": {
    "url": "https://app.mavioapp.com/shared/mtg_8f3k2j1m4n5p?token=shr_tok_x9y8z7w6",
    "expires_at": null
  },
  "created_at": "2026-04-14T09:30:00Z"
}