Overview
Webhook events for Note resources. All note events useresourceType: "Note".
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
- When all audio data processing is complete and text conversion and paragraph generation are finished
- Important: This event can occur multiple times for real-time meeting notes, as recording/stopping may happen several times during a single meeting session
- When you receive this event, you can retrieve the complete note information at that point in time
note.user_content.updated
- When a user manually edits the note content
note.ended
- Triggered when a note is completely finished (after all processing is complete)
- Fires only once per note lifecycle, unlike
note.recording.completedwhich can fire multiple times - This is the definitive event for note completion
- Use this event when you need to know that a note has reached its final state
Example Payload
Resource Data
Note events include the complete Note resource data. See the Note Schema for field descriptions. Important: Note resources contain only metadata. For transcript content, use the Paragraphs API to retrieve the actual text data.Guide
Real-time Meeting Notes
recording.completedcan fire multiple times for the same note in real-time meetings- Always fetch fresh note data when receiving this event
note.ended Event:
note.endedfires only once when a note is completely finished, enabling clearer lifecycle management- Unlike
recording.completed, which can fire multiple times during a meeting,note.endedsignals the definitive end - Both
recording.completedandnote.endedevents are supported and can be used together depending on your needs
- Meeting starts → recording begins
- Recording pauses → transcript & summary processing →
note.recording.completedfired (Event #1) - Recording resumes → continues processing
- Recording stops → transcript & summary processing →
note.recording.completedfired (Event #2)

