Changelog

Notetaker API and webhooks

Programmatically access Calendly meeting recaps and subscribe to recap lifecycle events. These endpoints and webhooks make post-meeting content, including summaries, action items, discussion notes, and transcripts, available to external systems like CRMs, task managers, collaboration platforms, workflow engines, and AI assistants. Recaps cover both Calendly-scheduled meetings and external meetings.

Included endpoints:

• GET /meeting_recaps/{recap_uuid} – Retrieve a single recap with highlights and metadata
• GET /meeting_recaps – List recaps with optional filters (event, user, organization, attendee, min_start_time, max_start_time, and more)
• PATCH /meeting_recaps/{recap_uuid} – Update a recap’s highlights (summary, action items, discussion)
• DELETE /meeting_recaps/{recap_uuid} – Delete a recap
• GET /meeting_recaps/{recap_uuid}/transcript – Retrieve the full transcript for a recap

New webhook events:

• meeting_recap.created – Fires when a recap is created, for both Calendly-scheduled and external meetings.
• meeting_recap.updated – Fires when recap highlights change (summary, action items, discussion). Changes to meeting notes, attendees, or timing do not trigger this event. Share link creation and removal are also surfaced here.
• meeting_recap.deleted – Tombstone event that fires when a recap is permanently deleted. Payload includes only the recap URI and deleted_at timestamp.

New OAuth scopes:

• meeting_recaps:read – Grants read access to meeting recap resources, including transcripts. Required to create Notetaker webhook subscriptions.
• meeting_recaps:write – Grants permission to update and delete meeting recap resources. Implicitly includes meeting_recaps:read.