Skip to Content
Copy and personalization

Voices

Voices are the speakers Kenso can use for LinkedIn AI voice notes: Deepgram voices, ElevenLabs stock voices and voices the workspace imports from its own ElevenLabs account. A voice note step names its voice by provider and voiceId. Importing a voice needs the workspace's ElevenLabs API key in Settings, Integrations. Every call answers 503 voice_notes_unavailable while voice notes are not available.

Copy and personalization4 endpointsKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

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 voices

GET/v1/voicesvoices.list
Permission
Any workspace member except a Network member
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

Returns every voice the workspace can use in a voice note step: Deepgram voices, ElevenLabs stock voices and the workspace's imported voices. Early-access voices are left out. The whole list comes in one page: nextCursor is null and hasMore is false.

Narrow the list with provider, language and includeImported. A language such as fr matches every French voice, and a locale such as fr-CA matches only that locale. A multilingual voice (language is multi, as on every ElevenLabs voice) matches every language filter.

Errors:

  • 400 validation_failed: provider is not deepgram or elevenlabs.
  • 503 voice_notes_unavailable: voice notes are not available right now, or ElevenLabs did not answer. Try again later.

Open to any workspace member.

Needs the linkedin_voice_notes or whatsapp feature on your workspace. Until one of them is on, calls answer 404.

Parameters

NameInTypeRequiredDescription
providerquerystringoptionalOnly this provider's voices: deepgram or elevenlabs. Omit it to list both.
languagequerystringoptionalOnly voices that speak this language (such as fr, every French locale) or locale (such as fr-CA). Multilingual voices match every language. Omit it to list every language.
includeImportedquerybooleanoptionalWhether to include the workspace's imported ElevenLabs voices. Defaults to true.
limitqueryinteger (int32)optionalItems per page, from 1 to 200. Omit limit and cursor to get every item in one response, as before; with only cursor, 50 per page.
cursorquerystringoptionalThe nextCursor of the previous page. Omit it for the first page.
Request
curl -X GET "https://api.ken.so/v1/voices?limit=1" \
  -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 Voice. Each item has these fields. The response also carries pagination.

Show the 14 response fields and an example

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

Import an ElevenLabs voice

POST/v1/voicesvoices.import
Permission
The integrations permission
Rate limit
4,800 requests a minute per API key

Try it on developer.ken.so

Adds a voice from the workspace's own ElevenLabs account to the workspace's voices, so voice note steps can use it. Returns 201 with the voice, or 200 when the workspace had already imported it. You can import a removed voice again.

Send provider: "elevenlabs", the voiceId and rightsConfirmed: true, which confirms that the workspace has the rights to use the voice. Kenso checks that the voice is on the workspace's ElevenLabs account at the time of the call. ElevenLabs stock voices need no import.

Errors:

  • 400 validation_failed: rightsConfirmed is not true, provider is not elevenlabs, voiceId is not an ElevenLabs voice id, or the voice is a stock voice.
  • 404 not_found: the voice is not on the workspace's ElevenLabs account.
  • 409 provider_key_missing: the workspace has no ElevenLabs API key, or cannot use its own keys yet.
  • 502 provider_rejected: ElevenLabs refused the workspace's key. Check it in Settings, Integrations.
  • 503 voice_notes_unavailable: voice notes are not available right now, Kenso could not read the key, or ElevenLabs did not answer. Try again later.

Requires the integrations permission, and a member with the Client role cannot call it.

Needs the linkedin_voice_notes or whatsapp feature on your workspace. Until one of them is on, calls answer 404.

Request body

application/json, optional.

The voice to import.

FieldTypeRequiredDescription
providerstringoptionalMust be elevenlabs, the only provider whose voices you import.
voiceIdstringoptionalThe voice's id on the workspace's ElevenLabs account, at most 64 letters and digits.
rightsConfirmedbooleanoptionalMust be true. It confirms that the workspace has the rights to use the voice.
Request
curl -X POST "https://api.ken.so/v1/voices" \
  -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 '{
  "provider": "string",
  "voiceId": "string",
  "rightsConfirmed": true
}'

Response 201

Also answers 200. data is a Voice.

Show the 14 response fields and an example

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

List importable ElevenLabs voices

GET/v1/voices/importablevoices.list-importable
Permission
The integrations permission
Rate limit
240 requests a minute per API key

Try it on developer.ken.so

Returns the voices on the workspace's own ElevenLabs account, so you can pick one to import. Stock voices are left out, because GET /v1/voices lists them already. imported marks the voices this workspace has imported. The whole list comes in one page.

This call needs the workspace's ElevenLabs API key, which you add in Settings, Integrations.

Errors:

  • 409 provider_key_missing: the workspace has no ElevenLabs API key, or cannot use its own keys yet.
  • 502 provider_rejected: ElevenLabs refused the workspace's key. Check it in Settings, Integrations.
  • 503 voice_notes_unavailable: voice notes are not available right now, Kenso could not read the key, or ElevenLabs did not answer. Try again later.

Requires the integrations permission, and a member with the Client role cannot call it.

Needs the linkedin_voice_notes or whatsapp feature on your workspace. Until one of them is on, calls answer 404.

Request
curl -X GET "https://api.ken.so/v1/voices/importable" \
  -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 ImportableVoice. Each item has these fields. The response also carries pagination.

Show the 6 response fields and an example

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

Remove an imported voice

DELETE/v1/voices/{provider}/{voiceId}voices.remove
Permission
The integrations permission
Rate limit
4,800 requests a minute per API key

Try it on developer.ken.so

Removes an imported voice from the workspace. Returns 204. Voice note steps that use the voice keep their settings, but their notes now fail with voice_removed and Kenso sends the step's text instead.

Errors:

  • 404 not_found: the workspace has not imported this voice.
  • 503 voice_notes_unavailable: voice notes are not available right now. Try again later.

Requires the integrations permission, and a member with the Client role cannot call it.

Needs the linkedin_voice_notes or whatsapp feature on your workspace. Until one of them is on, calls answer 404.

Parameters

NameInTypeRequiredDescription
providerpathstringrequiredProvider of the voice. Only elevenlabs voices are imported.
voiceIdpathstringrequiredThe voice's id on ElevenLabs.
Request
curl -X DELETE "https://api.ken.so/v1/voices/elevenlabs/01JC8Z3K6Q2W4M7N9P5R1T3V5X" \
  -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