Voice Notes voice_notes
Preview a LinkedIn voice note step: Ken writes and speaks the note for up to 3 leads, free, 15 leads a day; and get a link to a voice note's audio (valid 1 hour).
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through voice_notes_read and changes through voice_notes_write. Each takes operation plus that operation's parameters, and your workspace role decides which operations you see.
Each operation with a route calls the Kenso API at https://api.ken.so with Authorization: Bearer <Kenso API key>, Ken-Version: 1.1 and X-Ken-Workspace-Id: <workspace id>. You can call that route directly with the same headers.
audio
Read. Early access: needs linkedin_voice_notes or whatsapp on for the workspace. GET https://api.ken.so/v1/voice-notes/{voiceNoteId}/audio
Path: voiceNoteId
Return a link to a voice note's audio.
GET /api/v1/voice-notes/{voiceNoteId}/audio. Staff, or a workspace with the flag of the note's channel,
linkedin_voice_notes or whatsapp (off is not_found), and inbox view, the access that shows the note's
script (without it permission_denied). Sends Ken-Version
1.1. The route redirects to the audio; this returns {"url": ...} and never downloads the file. The link
works for 1 hour, so fetch a new one rather than keeping it. A note still being generated is
voice_note_not_ready; audio deleted after 90 days is gone.
preview
Write. Early access: needs linkedin_voice_notes on for the workspace. POST https://api.ken.so/v1/voice-note-previews
Body (json): campaignId integer, contactIds array, step object
Preview a LinkedIn voice note step for 1 to 3 leads of a campaign.
POST /api/v1/voice-note-previews. Staff, or a workspace with the linkedin_voice_notes flag (campaigns edit).
Sends Ken-Version 1.1. body is the step's text fallback; voice is the voice_note step's voice object:
provider (deepgram | elevenlabs), voiceId, speed (null or 0.5-1.5), wordsMode (ken_writes with
instructions, or script with script), model (haiku | sonnet; null, never "", for haiku),
matchLeadLanguage. Ken writes and speaks each lead's note now, free. Returns {"items": [{"contactId",
"voiceNote"}]}: each voiceNote is status ready with audioUrl, or failed with failureReason; one lead
failing never fails the call. Each lead takes one of the workspace's 15 previews a day; past it,
quota_exceeded with quotaResetAt. An imported voice needs the workspace's ElevenLabs key
(provider_key_missing).