Whatsapp settings
The Whatsapp settings endpoints of the Kenso API.
Return the workspace's WhatsApp setting
GET
/v1/whatsapp-settingswhatsapp-settings.getNeeds the whatsapp feature on your workspace. Until it is on, calls answer 404.
Parameters
Name
In
Type
Required
Description
Ken-Version
In: 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. 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
In: 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.Response 200
data is a WhatsAppSettings.
Field
Type
Description
allowEuEeaUk
boolean
updatedAt
string (date-time)
Request
curl -X GET "https://api.ken.so/v1/whatsapp-settings" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 1.1" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
"success": true,
"data": {
"allowEuEeaUk": true,
"updatedAt": "2026-09-23T15:02:11Z"
}
}Change the workspace's WhatsApp setting
PATCH
/v1/whatsapp-settingswhatsapp-settings.updateNeeds the whatsapp feature on your workspace. Until it is on, calls answer 404.
Requires the members feature (workspace admins). allowEuEeaUk: true lets touches send WhatsApp to numbers in the EU, EEA and UK; the workspace answers for the legal basis.
Parameters
Name
In
Type
Required
Description
Ken-Version
In: 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. 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
In: 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.Request body
application/json, optional.
Field
Type
Required
Description
allowEuEeaUk
boolean
optional
Response 200
data is a WhatsAppSettings.
Field
Type
Description
allowEuEeaUk
boolean
updatedAt
string (date-time)
Request
curl -X PATCH "https://api.ken.so/v1/whatsapp-settings" \
-H "Authorization: Bearer $KEN_API_KEY" \
-H "Ken-Version: 1.1" \
-H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{
"allowEuEeaUk": true
}'Response 200
{
"success": true,
"data": {
"allowEuEeaUk": true,
"updatedAt": "2026-09-23T15:02:11Z"
}
}