Kenso MCP tools

Whatsapp whatsapp

Connect and manage WhatsApp accounts (sessions through Unipile): status, daily caps, pauses and working hours, and the workspace's EU, EEA and UK setting. Also the workspace's WhatsApp message templates: text with {{variables}}, up to 6 images and an optional voice.

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through whatsapp_read and changes through whatsapp_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.

Operations: message-templates-create, create-connect-session, message-templates-delete, delete, message-templates-get, get, whatsapp-settings-get, message-templates-list, list, message-templates-update, update, whatsapp-settings-update

message-templates-create

Write. Early access: needs whatsapp on for the workspace. POST https://api.ken.so/v1/message-templates

Body (json): authorSource string, body string, channel string, mediaIds array, name string, voiceId string, voiceProvider string

Create a WhatsApp message template, recorded as agent-written. Returns 201. body may use {{person.first_name}}, {{person.last_name}}, {{person.full_name}}, {{person.title}}, {{account.name}}, {{sender.first_name}}, {{sender.full_name}} and {{sender.company}}. media_ids: up to 6 message-media ids, not with a voice. voice_provider (deepgram or elevenlabs) with voice_id makes it a voice note (body at most 900 characters).

POST /api/v1/message-templates. Needs workspace_settings. name at most 120 characters, body at most 4000.

create-connect-session

Write. Early access: needs whatsapp on for the workspace. POST https://api.ken.so/v1/whatsapp-accounts/connect-sessions

Body (json): whatsappAccountId integer

Start a hosted WhatsApp connect or reconnect session. Returns 201 with a URL to scan. Omit whatsapp_account_id to connect a new account. Pass it to reconnect.

POST /api/v1/whatsapp-accounts/connect-sessions. Sends Ken-Version 1.1.
Requires Delivery edit, or approve_own_sends for the caller's own account (403 not_your_whatsapp
otherwise). A new account costs 1,500 credits a month, charged when it connects; the workspace must
hold one month up front (400 with the credit refusal). No seat limit. 503 while WhatsApp is switched off.

message-templates-delete

Write. Early access: needs whatsapp on for the workspace. DELETE https://api.ken.so/v1/message-templates/{messageTemplateId}

Path: messageTemplateId

Query: authorSource string

Delete a WhatsApp message template. Returns 204. An agent cannot delete a template a person wrote.

DELETE /api/v1/message-templates/{messageTemplateId}. Needs workspace_settings.

delete

Write. Early access: needs whatsapp on for the workspace. DELETE https://api.ken.so/v1/whatsapp-accounts/{whatsappAccountId}

Path: whatsappAccountId

Delete a WhatsApp account and its Unipile session. Returns 204. Requires Delivery edit.

DELETE /api/v1/whatsapp-accounts/{whatsappAccountId}. Sends Ken-Version 1.1. Stops the monthly charge.

message-templates-get

Read. Early access: needs whatsapp on for the workspace. GET https://api.ken.so/v1/message-templates/{messageTemplateId}

Path: messageTemplateId

Return one WhatsApp message template in the current workspace.

GET /api/v1/message-templates/{messageTemplateId}.

get

Read. Early access: needs whatsapp on for the workspace. GET https://api.ken.so/v1/whatsapp-accounts/{whatsappAccountId}

Path: whatsappAccountId

Return one WhatsApp account in the current workspace. Requires Delivery view.

GET /api/v1/whatsapp-accounts/{whatsappAccountId}. Sends Ken-Version 1.1. Same fields as list.

whatsapp-settings-get

Read. Early access: needs whatsapp on for the workspace. GET https://api.ken.so/v1/whatsapp-settings

Return the workspace's WhatsApp setting. Any member.

GET /api/v1/whatsapp-settings. Sends Ken-Version 1.1. Returns { allowEuEeaUk, updatedAt }; allowEuEeaUk
is false until a workspace admin turns it on.

message-templates-list

Read. Early access: needs whatsapp on for the workspace. GET https://api.ken.so/v1/message-templates

Query: channel string, cursor string, limit integer

List WhatsApp message templates in the current workspace, by id. channel accepts only whatsapp; limit 1 to 200.

GET /api/v1/message-templates. client_id is sent as X-Ken-Workspace-Id.

list

Read. Early access: needs whatsapp on for the workspace. GET https://api.ken.so/v1/whatsapp-accounts

Query: cursor string, limit integer

List WhatsApp accounts in the current workspace. Requires Delivery view.

GET /api/v1/whatsapp-accounts. Sends Ken-Version 1.1. client_id is sent as X-Ken-Workspace-Id.
Each account has status (connecting, connected, credentials_error, restricted, disconnected, deleted,
connect_failed), phoneE164, quietUntil (no new chats before it, 24 hours after a connect or reconnect),
rampStage 1-4, paused / pauseReason (manual, restricted, low_reply_rate) / pausedUntil, today's usage
(newChatsToday, messagesToday, checksToday), the caps in force (newChatCap, coldNewChatCap, messageCap,
checkCap) and the highest caps a user may set (newChatCapCeiling, messageCapCeiling), and unpaid.

message-templates-update

Write. Early access: needs whatsapp on for the workspace. PATCH https://api.ken.so/v1/message-templates/{messageTemplateId}

Path: messageTemplateId

Update a WhatsApp message template; absent fields stay. An agent cannot edit a template a person wrote. changes: name, body, media_ids ([] clears), voice_provider and voice_id (together; both None clears the voice).

PATCH /api/v1/message-templates/{messageTemplateId}. Needs workspace_settings.

update

Write. Early access: needs whatsapp on for the workspace. PATCH https://api.ken.so/v1/whatsapp-accounts/{whatsappAccountId}

Path: whatsappAccountId

Body (json): dailyMessageCap integer, dailyNewChatCap integer, paused boolean, resetCaps boolean, resetWorkingHours boolean, timezone string, workingHoursSchedule object

Update a WhatsApp account. Absent fields stay unchanged. Requires Delivery edit.

PATCH /api/v1/whatsapp-accounts/{whatsappAccountId}. Sends Ken-Version 1.1.
daily_new_chat_cap runs 0 to newChatCapCeiling and daily_message_cap 0 to messageCapCeiling (400 above);
reset_caps goes back to the ramp defaults. timezone is an IANA id (empty clears it);
working_hours_schedule takes all seven days (mon..sun, each {open, start, end}); reset_working_hours
clears them. paused=true pauses the account; paused=false resumes a manual or low_reply_rate pause and
is 409 restricted_pause while WhatsApp restricts the account.

whatsapp-settings-update

Write. Early access: needs whatsapp on for the workspace. PATCH https://api.ken.so/v1/whatsapp-settings

Body (json): allowEuEeaUk boolean

Allow or stop WhatsApp to EU, EEA and UK numbers for the workspace. Workspace admins only (members feature).

PATCH /api/v1/whatsapp-settings. Sends Ken-Version 1.1. allow_eu_eea_uk=true lets touches send WhatsApp
to numbers in the EU, EEA and UK; the workspace answers for the legal basis.