How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Calendly Notetaker API

The notetaker API from Calendly — 3 operation(s) for notetaker.

Calendly Notetaker API is one of 18 APIs that Calendly publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Notetaker. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 3 paths, and defines 90 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.calendly.com.

5 operations 3 paths 90 schemas 1 DELETE3 GET1 PATCH

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.calendly.com
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Calendly Notetaker API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (oauth2). It accepts HTTP bearer tokens (personal_access_token).

  • oauth2 — OAuth 2.0
  • personal_access_token — Personal Access Token

Paths & Operations 5

Across 3 paths, the API surfaces 5 operations — 1 DELETE, 3 GET, 1 PATCH. Each is listed below with its method, path, parameters, and response codes.

notetaker 5
DELETE
/meeting_recaps/{uuid}
Delete Recap
notetaker_delete-meeting-recaps-uuid 1 param → 204400401403404500
GET
/meeting_recaps/{uuid}
Get Recap
notetaker_get-meeting-recaps-uuid-recap 1 param → 200400401403404500
PATCH
/meeting_recaps/{uuid}
Update Recap
notetaker_update-meeting-recaps-uuid 1 param body → 200400401403404500
GET
/meeting_recaps/{uuid}/transcript
Get Transcript
notetaker_get-transcript-meeting-recaps 1 param → 200400401403404500
GET
/meeting_recaps
List Recaps
notetaker_list-meeting-recaps 7 params → 200400401403404500

Schemas 90

The contract defines 90 schemas that model the data the API accepts and returns. The most detailed are MeetingRecap (16 properties), MeetingRecapListItem (12 properties), Pagination (5 properties), ZoomConferenceDataSettingsGlobalDialInNumbersItems (5 properties). Each schema is shown below with its type and property counts.

ZoomConferenceDataSettingsGlobalDialInNumbersItems
object
5 properties
InsufficientScopeError
object
Caller does not have required oauth scopes
3 properties 3 required
MeetingRecapsUuidGetResponsesContentApplicationJsonSchemaTitle
string
Update-meeting-recaps-uuidRequestNotFoundError
object
Error Object
3 properties 2 required
MeetingRecapsErrorMessage
string
InviteeSpecifiedLocationType
string
The event location selected by the invitee
ZoomConferenceDataId
The conference ID provided by Zoom
Delete-meeting-recaps-uuidRequestForbiddenError
Notetaker_list-meeting-recaps_Response_200
object
Service response
2 properties 2 required
MicrosoftTeamsConferenceData
object
The conference metadata supplied by Microsoft Teams
2 properties
Update-meeting-recaps-uuidRequestInternalServerError
object
Error Object
3 properties 2 required
MeetingRecapsUuidDeleteResponsesContentApplicationJsonSchemaTitle
string
Notetaker_get-transcript-meeting-recaps_Response_200
object
1 property 1 required
Delete-meeting-recaps-uuidRequestUnauthorizedError
object
Error Object
3 properties 2 required
GotoMeetingConference
object
Details about an Event that will take place using a GotoMeeting conference. Location details will not be available 6 months after event has occurred.
4 properties 4 required
List-meeting-recapsRequestForbiddenError
InboundCall
object
Invitee will call meeting publisher at the specified phone number
3 properties 2 required
MeetingRecapsUuidTranscriptGetResponsesContentApplicationJsonSchemaTitle
string
InboundCallType
string
Indicates that the invitee will call the event host
Get-meeting-recaps-uuid-recapRequestUnauthorizedError
object
Error Object
3 properties 2 required
GoogleConferenceStatus
string
Indicates the current status of the Google conference Expect only pushed status to have a non-null value for the joinurl field. - processing Location details g…
GoogleConferenceType
string
The event location is a Google Meet or Hangouts conference
WebExConference
object
Details about an Event that will take place using a WebEx conference. Location details will not be available 6 months after event has occurred.
4 properties 4 required
InPersonMeetingType
string
Indicates that the event will be an in-person meeting.
CustomLocation
object
Use this to describe an existing Calendly-supported event location.
2 properties 2 required
Get-meeting-recaps-uuid-recapRequestNotFoundError
object
Error Object
3 properties 2 required
MeetingRecapsUuidTranscriptGetResponsesContentApplicationJsonSchemaMessage
string
Get-meeting-recaps-uuid-recapRequestInternalServerError
object
Error Object
3 properties 2 required
Delete-meeting-recaps-uuidRequestInternalServerError
object
Error Object
3 properties 2 required
MicrosoftTeamsConferenceStatus
string
Indicates the current status of the Microsoft Teams conference Expect only pushed status to have non-null values for joinurl & data fields. - processing Locati…
ZoomConferenceStatus
string
Indicates the current status of the Zoom conference Expect only pushed status to have non-null values for joinurl & data fields. - processing Location details…
Get-transcript-meeting-recapsRequestInternalServerError
object
Error Object
3 properties 2 required
ZoomConference
object
Meeting will take place in a Zoom conference. Location details will not be available 6 months after event has occurred.
4 properties 4 required
List-meeting-recapsRequestBadRequestError
object
Error Object
3 properties 2 required
MicrosoftTeamsConferenceDataAudioConferencing
object
3 properties
GotoMeetingConferenceData
object
The conference metadata supplied by GoToMeeting
2 properties
MeetingRecapsErrorTitle
string
MeetingRecapsUuidPatchResponsesContentApplicationJsonSchemaTitle
string
OutboundCall
object
Meeting publisher will call the Invitee
2 properties 2 required
ZoomConferenceDataExtra
object
1 property
Get-transcript-meeting-recapsRequestUnauthorizedError
object
Error Object
3 properties 2 required
Transcript
object
The meeting transcript as plain text.
2 properties 2 required
MeetingRecapsGetResponsesContentApplicationJsonSchemaTitle
string
Delete-meeting-recaps-uuidRequestBadRequestError
object
Error Object
3 properties 2 required
Notetaker_get-meeting-recaps-uuid-recap_Response_200
object
1 property 1 required
MeetingRecapsUuidPatchResponsesContentApplicationJsonSchemaMessage
string
GoogleConference
object
Details about an Event that will take place using a Google Meet / Hangout conference. Location details will not be available 6 months after event has occurred.
3 properties 3 required
WebExConferenceStatus
string
Indicates the current status of the WebEx conference Expect only pushed status to have non-null values for joinurl & data fields. - processing Location details…
Delete-meeting-recaps-uuidRequestNotFoundError
object
Error Object
3 properties 2 required
Get-transcript-meeting-recapsRequestForbiddenError
List-meeting-recapsRequestUnauthorizedError
object
Error Object
3 properties 2 required
ZoomConferenceDataSettings
object
1 property
Get-transcript-meeting-recapsRequestBadRequestError
object
Error Object
3 properties 2 required
List-meeting-recapsRequestNotFoundError
object
Error Object
3 properties 2 required
MeetingRecapAttendeesItems
object
3 properties 3 required
InviteeSpecifiedLocation
object
Information about an event location that’s specified by the invitee.
2 properties 2 required
MeetingRecapListItemAttendeesItems
object
3 properties 3 required
MeetingRecapsGetParametersStatus
string
Notetaker_update-meeting-recaps-uuid_Response_200
object
1 property 1 required
Update-meeting-recaps-uuidRequestBadRequestError
object
Error Object
3 properties 2 required
OutboundCallType
string
Indicates that the event host (publisher) will call the invitee
InPersonMeeting
object
Information about the physical (in-person) event location
3 properties 2 required
Get-transcript-meeting-recapsRequestNotFoundError
object
Error Object
3 properties 2 required
MeetingRecapsError
object
Permission Denied
2 properties 2 required
MeetingRecap
object
A meeting recap generated for a Calendly scheduled event or an external event.
16 properties 3 required
GotoMeetingConferenceType
string
The event location is a GoToMeeting conference
ErrorResponseDetailsItem
object
3 properties 1 required
InsufficientScopeErrorTitle
string
WebExConferenceDataTelephony
object
1 property 1 required
MeetingRecapsUuidGetResponsesContentApplicationJsonSchemaMessage
string
MicrosoftTeamsConferenceType
string
The event location is a Microsoft Teams conference
ZoomConferenceData
object
The conference metadata supplied by Zoom
4 properties
WebExConferenceDataTelephonyCallInNumbersItems
object
3 properties 3 required
Update-meeting-recaps-uuidRequestForbiddenError
Location
The polymorphic base type for an event location that Calendly supports
MicrosoftTeamsConference
object
Meeting will take place in a Microsoft Teams conference. Location details will not be available 6 months after event has occurred.
4 properties 4 required
Get-meeting-recaps-uuid-recapRequestForbiddenError
WebExConferenceData
object
The conference metadata supplied by GoToMeeting
3 properties 3 required
MeetingRecapsUuidDeleteResponsesContentApplicationJsonSchemaMessage
string
InsufficientScopeErrorMessage
string
Get-meeting-recaps-uuid-recapRequestBadRequestError
object
Error Object
3 properties 2 required
GotoMeetingConferenceStatus
string
Indicates the current status of the GoToMeeting conference Expect only pushed status to have non-null values for joinurl & data fields. - processing Location d…
ZoomConferenceType
string
The event location is a Zoom conference
WebExConferenceType
string
The event location is a WebEx conference
MeetingRecapListItem
object
A meeting recap list item generated for a Calendly scheduled event or an external event.
12 properties 4 required
List-meeting-recapsRequestInternalServerError
object
Error Object
3 properties 2 required
Update-meeting-recaps-uuidRequestUnauthorizedError
object
Error Object
3 properties 2 required
CustomLocationType
string
The event location doesn't fall into a standard category defined by the event host (publisher)
MeetingRecapsGetResponsesContentApplicationJsonSchemaMessage
string
Pagination
object
5 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

calendly-notetaker-api-openapi.yml Raw ↑

Other APIs Calendly publishes across the network.

Calendly Webhook API
Calendly Embed API
Calendly Availability API
Calendly Groups API
Calendly Organizations API
Calendly Shares API
Calendly Users API
Calendly Activity Log API
Calendly Contacts API
Calendly Data Compliance API
Calendly Event Types API
Calendly Locations API
Where this information came from

This is an independent, third-party profile of Calendly Notetaker API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.