Localized steps
A localization is one email or LinkedIn step of a campaign, written in one of the languages the campaign turns on. Kenso writes localizations in the background and checks each one. When the campaign's languageMode is auto, Kenso sends each contact the approved localization of their language. Ask Kenso to write the localizations, poll the list until they are written, then approve, regenerate or edit each one.
Path parameters
The endpoints whose path names one of these take it as described here. An endpoint's own table lists a path parameter only when it describes it differently.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
campaignId | path | integer (int64) | required | Id of the campaign. |
localizationId | path | integer (int64) | required | Id of the localization. |
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. |
List a campaign's localizations
/v1/campaigns/{campaignId}/localizationscampaign-localizations.list- Permission
- Campaigns view
- Rate limit
- 12,000 requests a minute per API key
multilingual_outreach feature on your workspace. Until it is on, calls answer 404.Returns the localizations of the campaign's current email and LinkedIn steps. Use it to review the localized text, and to poll while Kenso writes it.
Items come email first, then by step order, variant and language. Filter with language, stepId and channel. An email and a LinkedIn step can share an id, so add channel when you filter by stepId. generating is true while Kenso has the localization queued: read the list again until it is false. stale is true when the step text or the market pack changed after Kenso wrote the localization: generate it again. The whole result comes in one page, so hasMore is always false.
Errors:
400 validation_failed:channelis notemailorlinkedin.404 not_found: the campaign does not exist in this workspace.
Requires Campaigns view.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
language | query | string | optional | Only the localizations in this language, as a locale such as fr-FR, in any casing. Omit it for every language. |
stepId | query | integer (int64) | optional | Only the localizations of the email or LinkedIn step with this id. An email step and a LinkedIn step can share an id: add channel to pick one. |
channel | query | string | optional | Only the localizations of one channel: email or linkedin. Omit it for both. |
limit | query | integer (int32) | optional | Items 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. |
cursor | query | string | optional | The nextCursor of the previous page. Omit it for the first page. |
curl -X GET "https://api.ken.so/v1/campaigns/812/localizations?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 CampaignLocalization. Each item has these fields. The response also carries pagination.
Show the 23 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Edit a localization's text
/v1/campaigns/{campaignId}/localizations/{localizationId}campaign-localizations.update- Permission
- Campaigns edit
- Rate limit
- 4,800 requests a minute per API key
multilingual_outreach feature on your workspace. Until it is on, calls answer 404.Replaces the text of one localization with your own. Use it to fix wording by hand.
Send subjectLine, bodyContent or both. A field you leave out keeps its stored text. A LinkedIn localization has no subject. Kenso sets the unsubscribe link text to the market pack's wording, runs the rule checks on the new text without a model call, and stores their result in qaReport. Kenso also stores text that breaks a rule, so you can keep working on it, but approval waits until the rules pass. Send channel only when an email and a LinkedIn localization of the campaign share the id.
editedByHuman becomes true and the localization becomes a draft. It loses any approval, so a live campaign stops sending it until it is approved again. The English mirror and qaScore keep their values, which describe the text before the edit.
When campaign images or videos are on for the workspace, Kenso checks image and video tokens in an email text as a sequence save does, and stores nothing when the check fails. A save refuses, for example, more than two images, an image in the subject or in a handwritten letter, and an image that is not on its own line or in its own paragraph.
Errors:
400 validation_failedwith detail coderequired: neither field was sent, the body is blank, or the subject is blank for a step that has one.400 validation_failedwith detail codenot_supported:subjectLinewas sent for a LinkedIn localization.400 validation_failedwith detail codeinvalid: the text has image or video tokens a sequence save would refuse. The message says why.400 validation_failedwith detail codeunsupported_language: Kenso has no market pack to check this language with.400 validation_failedwith detail codechannel_required: an email and a LinkedIn localization share this id. Addchannel.400 validation_failedwith detail codeinvalid_value:channelis notemailorlinkedin.404 not_found: the campaign or the localization does not exist in this workspace, or the localization's step was removed.409 localization_generating: Kenso is writing this localization and would overwrite the edit. Read it again oncegeneratingis false.409 conflict: the localization changed while Kenso saved the edit. Read it again and retry.
Requires Campaigns edit.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
channel | query | string | optional | email or linkedin. Needed only when an email and a LinkedIn localization of the campaign share the id. |
Request body
application/json, optional.
The new subject, body or both.
| Field | Type | Required | Description |
|---|---|---|---|
subjectLine | string | optional | The localized subject. Only for an email localization. It cannot be blank when the step has a subject. |
bodyContent | string | optional | The localized body. It cannot be blank. |
curl -X PATCH "https://api.ken.so/v1/campaigns/812/localizations/812" \
-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 '{
"subjectLine": "string",
"bodyContent": "string"
}'Response 200
data is a CampaignLocalization.
Show the 23 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Generate a campaign's localizations
/v1/campaigns/{campaignId}/localizationscampaign-localizations.generate- Permission
- Campaigns edit
- Credits
- Varies with the request (
translation) - Rate limit
- 4,800 requests a minute per API key
multilingual_outreach feature on your workspace. Until it is on, calls answer 404.Queues Kenso to write the campaign's steps in the languages it turns on. Call it after you turn on a language or change step text. Kenso writes the queued localizations in the background.
The body is optional, for example { "languages": ["fr-FR"], "stepIds": [11], "channel": "email" }. An absent or empty field means every enabled language, every step and both channels. Kenso writes only active steps with text. It skips steps built in Studio and LinkedIn connection requests with an AI-written note. For each step and language:
- With no localization yet, Kenso creates one as a queued draft.
- Kenso queues again a localization that is
stale,failedorneeds_review, or that it wrote from older step text or an older market pack. - A current
draftorapprovedlocalization, and one already queued, stay as they are. - Kenso queues again a localization a member edited only when
stepIdsnames its step, so a new market pack never replaces a member's text unasked.
The response is 202 with every localization of the campaign, the same list as GET /v1/campaigns/{campaignId}/localizations. A queued localization has generating true until Kenso has written it, so poll the list to follow progress. Each localization Kenso writes costs credits. With no credits left, the localization ends failed with lastError set to insufficient_credits.
Errors:
400 validation_failedwith detail codeno_enabled_languages: the campaign turns on no language. SetenabledLanguageson the campaign first.400 validation_failedwith detail codelanguage_not_enabled: a locale inlanguagesis not in the campaign'senabledLanguages.400 validation_failedwith detail codeunsupported_language: Kenso has no market pack to write an enabled language with.400 validation_failedwith detail codestep_not_localizable: a step instepIdsis not an active step of the campaign with text to localize.400 validation_failedwith detail codeinvalid_value:channelis notemailorlinkedin.404 not_found: the campaign does not exist in this workspace.409 invalid_statewith detail codelocalization_disabled: localization is not turned on for this workspace yet, so Kenso queued nothing.
Requires Campaigns edit.
Request body
application/json, optional.
Optional. Which languages, steps and channel to write.
| Field | Type | Required | Description |
|---|---|---|---|
languages | array of string | optional | Locales to write, such as fr-FR. Each must be in the campaign's enabledLanguages. |
stepIds | array of integer (int64) | optional | Ids of the campaign's email or LinkedIn steps to write. An email and a LinkedIn step can share an id: add channel to pick one. Naming a step also queues its localizations that a member edited. |
channel | string | optional | Write only one channel's steps: email or linkedin. Absent means both. |
curl -X POST "https://api.ken.so/v1/campaigns/812/localizations" \
-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 '{
"languages": [
"fr-FR"
],
"stepIds": [
812
],
"channel": "email"
}'Response 202
data is a list of CampaignLocalization. Each item has these fields. The response also carries pagination.
Show the 23 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Approve a localization
/v1/campaigns/{campaignId}/localizations/{localizationId}/approvecampaign-localizations.approve- Permission
- Campaigns edit
- Rate limit
- 4,800 requests a minute per API key
multilingual_outreach feature on your workspace. Until it is on, calls answer 404.Approves one localization for sending, so an auto campaign sends it to the contacts of that language. Kenso records the caller and the time.
Kenso approves only a current draft that passed its checks: the rule checks passed, and qaScore reached the market pack's threshold. A localization a member edited needs only the rule checks. Read qaReport to see what failed. Send channel only when an email and a LinkedIn localization of the campaign share the id.
Errors:
400 validation_failedwith detail codechannel_required: an email and a LinkedIn localization share this id. Addchannel.400 validation_failedwith detail codeinvalid_value:channelis notemailorlinkedin.404 not_found: the campaign or the localization does not exist in this workspace, or the localization's step was removed.409 localization_generating: Kenso is writing this localization. Read it again oncegeneratingis false.409 localization_not_approvablewith detail codenot_draft,stale,qa_failedorscore_below_threshold: the localization is not a current draft that passed its checks. Generate astaleone again, and edit or regenerate the others.409 conflict: the localization changed while Kenso saved the approval. Read it again and retry.
Requires Campaigns edit.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
channel | query | string | optional | email or linkedin. Needed only when an email and a LinkedIn localization of the campaign share the id. |
curl -X POST "https://api.ken.so/v1/campaigns/812/localizations/812/approve" \
-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 CampaignLocalization.
Show the 23 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Regenerate a localization
/v1/campaigns/{campaignId}/localizations/{localizationId}/regeneratecampaign-localizations.regenerate- Permission
- Campaigns edit
- Credits
- Varies with the request (
translation) - Rate limit
- 4,800 requests a minute per API key
multilingual_outreach feature on your workspace. Until it is on, calls answer 404.Queues Kenso to write one localization again, optionally with an instruction. Use it when a draft needs changes you do not want to make by hand.
The body is optional, for example { "instruction": "Shorter, and less formal." }. With an instruction, Kenso rewrites the current text to follow it. Without one, Kenso writes the localization anew. Both replace text a member edited. The localization becomes a draft at once and loses any approval, so a live campaign stops sending it until it is approved again. Meanwhile the campaign's languageFallback decides what the contacts of that language get: the source text, or a hold. The response is 202 with the localization, and generating stays true until Kenso has written it. Send channel only when an email and a LinkedIn localization of the campaign share the id.
Errors:
400 validation_failedwith detail codetoo_long:instructionis longer than 2,000 characters.400 validation_failedwith detail codelanguage_not_enabled: the campaign no longer turns on this localization's language.400 validation_failedwith detail codestep_not_localizable: the step is no longer active or has no text to localize.400 validation_failedwith detail codeunsupported_language: Kenso has no market pack to write this language with.400 validation_failedwith detail codechannel_required: an email and a LinkedIn localization share this id. Addchannel.400 validation_failedwith detail codeinvalid_value:channelis notemailorlinkedin.404 not_found: the campaign or the localization does not exist in this workspace, or the localization's step was removed.409 localization_generating: Kenso already has this localization queued.409 invalid_statewith detail codelocalization_disabled: localization is not turned on for this workspace yet.409 conflict: the localization changed while Kenso saved the request. Read it again and retry.
Requires Campaigns edit.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
channel | query | string | optional | email or linkedin. Needed only when an email and a LinkedIn localization of the campaign share the id. |
Request body
application/json, optional.
Optional. An instruction for the new text.
| Field | Type | Required | Description |
|---|---|---|---|
instruction | string | optional | What to change, in a sentence or two, such as Shorter, and less formal. Up to 2,000 characters. Absent writes the localization anew. |
curl -X POST "https://api.ken.so/v1/campaigns/812/localizations/812/regenerate" \
-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 '{
"instruction": "string"
}'Response 202
data is a CampaignLocalization.
Show the 23 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
More in Campaigns:CampaignsEmail sequencesLinkedIn sequencesSegment email sequencesSegment LinkedIn sequencesSequence variablesSequences with conditionsSequence importSegmentsLead listsShare linksClient approvalsSending capacityAuto-pausesCampaign languagesText translationMarket packsCountry complianceCampaign imagesAll resources