Skip to Content
CRM

Meeting notes

Meeting notes are call notes or a transcript you keep on an account, with each attendee linked to a person on it. Add a note for a meeting that happened, list an account's notes (each with a short excerpt), read one note in full and delete one. A note also shows on the account's meetings. A note on a private meeting shows only to the meeting's owner and workspace admins.

CRM4 endpointsKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

Path parameters

The endpoints whose path names one of these take it as described here. An endpoint's own table lists a path parameter only when it describes it differently.

NameInTypeRequiredDescription
accountIdpathinteger (int64)required
meetingNoteIdpathinteger (int64)required

Headers

The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.

NameInTypeRequiredDescription
Ken-Versionheaderstring, one of: 2026-11-02, 1.1optionalThe API version, a date in YYYY-MM-DD form. 1.1 is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy.
X-Ken-Workspace-Idheaderinteger (int64)optionalThe id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers 400 workspace_required. A workspace you are not a member of answers 404 not_found.

List an account's meeting notes

GET/v1/accounts/{accountId}/meeting-notesmeeting-notes.list
Permission
Accounts view
Rate limit
12,000 requests a minute per API key
Needs the accounts feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

Newest first by occurredAt. Items omit notes and carry excerpt (the first 280 characters); get one note for the full text. A note on a private meeting shows only to the meeting's owner and workspace admins, on list, get and delete. Requires accounts view.

Parameters

NameInTypeRequiredDescription
limitqueryinteger (int32)optionalItems per page, from 1 to 200. Default 50.
cursorquerystringoptionalThe nextCursor of the previous page. Omit it for the first page.
Request
curl -X GET "https://api.ken.so/v1/accounts/812/meeting-notes?limit=50" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"

Response 200

data is a list of MeetingNote. Each item has these fields. The response also carries pagination.

Show the 12 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Add meeting notes or a transcript to an account

POST/v1/accounts/{accountId}/meeting-notesmeeting-notes.create
Permission
Accounts edit
Rate limit
4,800 requests a minute per API key
Needs the accounts feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

title (1-200 characters), occurredAt (ISO 8601, at most one day ahead) and notes (1-200,000 characters) are required. source: manual (default), transcript, gong, fathom, fireflies, zoom, teams, google_meet, other. attendees: at most 50 of {name, email}, each with a name or an email; an email listed twice is stored once. An email that matches a person in the workspace links personId, and stakeholderId when that person is a stakeholder on this account; no person is created. Creates the meeting the notes belong to (status done, no calendar event, owned by the caller's member) with the attendees as participants, and records the added notes on the account timeline. That meeting counts as one of the account's meetings: notes stored before the account's first booking make that booking not its first meeting, so its meeting.booked webhook carries firstMeeting false and meeting_booked skills set to first meetings only do not run for it.

For a call already on the account, such as a synced calendar meeting, send meetingId and notes only: the note goes on that meeting and no meeting is created, so the account's meeting counts and first-meeting detection do not move. The response carries that meeting's title, time, source and participants. title, occurredAt, source and attendees sent with it are 400 (invalid). A meeting that is not on this account, or that the caller cannot see (another member's private meeting), is 404. Deleting the note later keeps the meeting. The response's meetingId names the meeting either way. Requires accounts edit.

Request body

application/json, optional.

FieldTypeRequiredDescription
meetingIdinteger (int64)optionalA meeting already on this account, such as a synced calendar meeting: the note goes on it and no meeting is created. Send only notes with it; title, occurredAt, source and attendees are the meeting's.
titlestringoptional1 to 200 characters. Required without meetingId.
occurredAtstring (date-time)optionalWhen the meeting happened. ISO 8601; a time without an offset is UTC. At most one day ahead. Required without meetingId.
sourcestringoptionalmanual (default), transcript, gong, fathom, fireflies, zoom, teams, google_meet or other. Not with meetingId.
attendeesarray of MeetingNoteAttendeeBodyoptionalAt most 50. Each needs a name or an email. Not with meetingId.
notesstringrequiredThe notes or transcript, 1 to 200,000 characters. Required.
Request
curl -X POST "https://api.ken.so/v1/accounts/812/meeting-notes" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Discovery call",
  "occurredAt": "2026-10-14T15:00:00Z",
  "source": "zoom",
  "attendees": [
    {
      "name": "Amanda Chen",
      "email": "[email protected]"
    },
    {
      "name": "Alex Morgan",
      "email": "[email protected]"
    }
  ],
  "notes": "Amanda owns the outbound budget. Pilot in Q1 with two SDRs; she wants LinkedIn and email in one place."
}'

Response 201

data is a MeetingNote.

Show the 12 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Return one meeting note with its full text

GET/v1/meeting-notes/{meetingNoteId}meeting-notes.get
Permission
Accounts view
Rate limit
12,000 requests a minute per API key
Needs the accounts feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

Requires accounts view.

Request
curl -X GET "https://api.ken.so/v1/meeting-notes/812" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"

Response 200

data is a MeetingNote.

Show the 12 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Delete a meeting note

DELETE/v1/meeting-notes/{meetingNoteId}meeting-notes.delete
Permission
Accounts edit
Rate limit
4,800 requests a minute per API key
Needs the accounts feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

Soft delete: the note leaves list and get. Its meeting is deleted too when nothing else is on it (no calendar event, never recorded, no transcript, no other notes). Returns 204. Requires accounts edit.

Request
curl -X DELETE "https://api.ken.so/v1/meeting-notes/812" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"

Response 204

Response 204
HTTP/1.1 204 No Content

On this page