Skip to Content
Campaigns

Market packs

Market packs: the language facts Kenso writes each locale with, and the cold email notes of the countries it covers.

Campaigns2 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.

List market packs

GET/v1/marketsmarkets.list
Permission
Any signed-in caller
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

Returns every market pack Kenso offers, ordered by locale. Use it to show the languages a campaign can turn on.

Each item has the pack's locale, language, name, status and the countries it writes for. Read GET /v1/markets/{locale} for the whole pack. Page with limit and cursor: pass nextCursor as cursor to read the next page.

Errors:

  • 400 validation_failed: limit is not from 1 to 200, or cursor is not a cursor from this list.

Open to any signed-in caller, including an API key limited to a permission template.

Parameters

NameInTypeRequiredDescription
limitqueryinteger (int32)optionalNumber of market packs per page, from 1 to 200, default 50.
cursorquerystringoptionalThe nextCursor from the previous page. Omit it for the first page.
Request
curl -X GET "https://api.ken.so/v1/markets?limit=50" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02"

Response 200

data is a list of MarketSummary. Each item has these fields. The response also carries pagination.

Show the 5 response fields and an example

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

Get a market pack

GET/v1/markets/{locale}markets.get
Permission
Any signed-in caller
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

Returns one market pack in full, with the countries it writes for and each country's cold email rules. Use it to read the writing rules Kenso follows for a locale.

locale is a pack locale such as fr-FR, in any letter case and with - or _: FR-fr and fr_FR both read as fr-FR. pack holds the whole pack: formality, greetings, sign-offs, style, banned and spam phrases, and examples. countries lists the countries the pack writes for, each with its languages and coldEmail. coldEmail.regime is opt_out, consent or unresolved, and coldEmail.requiresAcknowledgement is true when a member must acknowledge the country's rules before a campaign with contacts there launches. Every cold email note ends with "Not legal advice."

Errors:

  • 404 not_found: no pack has this locale. A bare language such as fr is not a locale.

Open to any signed-in caller, including an API key limited to a permission template.

Parameters

NameInTypeRequiredDescription
localepathstringrequiredLocale of the pack, such as fr-FR.
Request
curl -X GET "https://api.ken.so/v1/markets/fr-FR" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02"

Response 200

data is a Market.

Show the 6 response fields and an example

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


On this page