Voice notes
Voice notes are the LinkedIn audio messages Kenso records for a contact from a voice note step. Touches, thread messages and account activity show each one as a voiceNote object with its status, and with an audioUrl while its audio is stored. Play the audio with this section's call.
Headers
The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Ken-Version | header | string, one of: 2026-11-02, 1.1 | optional | The 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-Id | header | integer (int64) | optional | The 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. |
Get a voice note's audio
/v1/voice-notes/{voiceNoteId}/audiovoice-notes.audio- Permission
- Inbox view
- Rate limit
- 12,000 requests a minute per API key
Redirects with 302 to a link to the note's audio. The link works for 1 hour, so call this again each time you play the note instead of keeping the link.
Kenso deletes a note's audio 90 days after the note was sent, or after it was made when it was never sent.
Errors:
403 permission_denied: the member cannot view the Inbox, so cannot hear its messages.404 not_found: the note is not in this workspace, or it has no audio.409 voice_note_not_ready: Kenso is still making the audio. Try again shortly.410 gone: Kenso deleted the audio after 90 days.503 voice_notes_unavailable: voice notes are not available right now. Try again later.
Requires Inbox view.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
voiceNoteId | path | integer (int64) | required | The voice note's id, from its voiceNote object. |
curl -X GET "https://api.ken.so/v1/voice-notes/812/audio" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"More in Copy and personalization:Custom variablesAI promptsPrompt versionsImage variablesCopy gradesCopy checksVoicesVoice note previewsMessage templatesAll resources