Clarify APIMeetings and transcripts
Upload transcripts and manage recordings
Before bulk transcript uploads, disable automatic action item creation in Settings > Meetings — otherwise Clarify generates action items from every transcript. Re-enable it after the import.
Upload a transcript
POST /meetings/{meetingId}/transcript
Uploads a transcript to a meeting record. Use version 1.11 of the transcript format.
{
"version": "1.11",
"title": "Discovery call — Acme Corp",
"date": "2024-03-15T14:00:00Z",
"duration": 2731,
"participants": [
{
"id": "p1",
"name": "Taylor Reeves",
"email": "taylor@clarify.ai"
},
{
"id": "p2",
"name": "Jordan Kim",
"email": "jordan@acme.com"
}
],
"segments": [
{
"speakerId": "p1",
"startTime": 0,
"endTime": 12.4,
"text": "Thanks for making the time today. Can you walk me through your current process?"
},
{
"speakerId": "p2",
"startTime": 13.1,
"endTime": 34.7,
"text": "Sure. Right now everything lives in spreadsheets. We track deals manually and it's getting unwieldy."
}
]
}duration is in seconds. startTime and endTime are in seconds from the start of the recording. Each segment maps to a single speaker turn.
Returns 200 with the updated meeting record on success.
Get recording artifacts
POST /meetings/{meetingId}/recordings/{id}/artifacts
Returns signed URLs for video and transcription files. URLs expire after a short window — fetch them close to when you need them.
{
"data": {
"video_url": "https://storage.clarify.ai/recordings/rec_01HX.../video.mp4?token=...",
"transcript_url": "https://storage.clarify.ai/recordings/rec_01HX.../transcript.vtt?token=..."
}
}Enable recording
POST /meetings/{meetingId}/recording
Starts recording for an active meeting. No request body required. Returns 200 on success.
Disable recording
DELETE /meetings/{meetingId}/recording
Stops recording for a meeting. Returns 204 No Content on success.