Note Events

​

Overview

​

Event Details

​

note.created

• When starting a live-voice note recording
• When creating a note from a recording file

​

note.deleted

• When a user permanently deletes a note

​

note.recording.completed (Recording paused)

• Fires each time live recording stops, after the last paragraph summary for that recording segment is saved. Recording can stop for any reason, such as pausing the recording, ending the note while recording, or an error
• Does not fire if no new transcript was captured during that segment
• Can fire multiple times for the same note because it fires each time recording stops
• The event name keeps completed for compatibility, but it does not mean the note has ended. Use note.ended for the final state

​

note.user_content.updated

• When a user manually edits the note content

​

note.ended

• Fires when all processing for the note is complete
• Unlike note.recording.completed, it fires only once per note

​

note.participants.updated

• Triggered when meeting participants are added or removed from a note
• Does not fire when an existing participant’s name or email is updated
• The resource field contains the full Note object with the updated participants array

​

Example Payload

​

Resource Data

​

Guide

​

Distinguish a stopped recording from an ended note

1. Meeting starts → recording begins
2. Recording pauses → transcript and summary processing for that segment → note.recording.completed fires
3. Recording resumes → processing continues
4. Note ends while recording → note.recording.completed fires for the last segment → note.ended fires

async function handleRecordingSegmentCompleted(event) {
  const noteId = event.data.resourceId;
  const note = event.data.resource;
  const paragraphs = await fetchNoteParagraphs(noteId);

  processRecordingSegment(note, paragraphs);
}

async def handle_recording_segment_completed(event):
    note_id = event['data']['resourceId']
    note = event['data']['resource']
    paragraphs = await fetch_note_paragraphs(note_id)

    process_recording_segment(note, paragraphs)

func handleRecordingSegmentCompleted(event WebhookEvent) error {
    noteID := event.Data.ResourceID
    note := event.Data.Resource

    paragraphs, err := fetchNoteParagraphs(noteID)
    if err != nil {
        return err
    }

    return processRecordingSegment(note, paragraphs)
}

suspend fun handleRecordingSegmentCompleted(event: WebhookEvent) {
    val noteId = event.data.resourceId
    val note = event.data.resource
    val paragraphs = fetchNoteParagraphs(noteId)

    processRecordingSegment(note, paragraphs)
}