Skip to Content
Inbox

Reply templates

Saved reply bodies you and your agents reuse in the inbox.

Inbox5 endpointsKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

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.

NameInTypeRequiredDescription
replyTemplateIdpathinteger (int64)requiredThe template's numeric id.

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 reply templates

GET/v1/reply-templatesreply-templates.list
Permission
Inbox view
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

Returns the workspace's reply templates, oldest first by id. Page with limit and cursor.

Errors:

  • 400 validation_failed: limit is outside 1 to 200, or cursor is invalid.

Requires Inbox view.

Parameters

NameInTypeRequiredDescription
cursorquerystringoptionalThe nextCursor from the previous page. Omit it for the first page.
limitqueryinteger (int32)optionalTemplates per page, from 1 to 200. Omitted, it is 50.
Request
curl -X GET "https://api.ken.so/v1/reply-templates?limit=50" \
  -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 ReplyTemplate. Each item has these fields. The response also carries pagination.

Show the 8 response fields and an example

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

Create a reply template

POST/v1/reply-templatesreply-templates.create
Permission
Inbox edit and the workspace_settings permission
Rate limit
4,800 requests a minute per API key

Try it on developer.ken.so

Saves a new reply template for the whole workspace. name and body are required.

Kenso sets the author from the caller. A person signed in to the Kenso app writes as user. An agent (any caller that sends the header X-Ken-Actor: agent) or an API key writes as agent. Sending authorSource: agent marks a person's template as an agent's; authorSource: user never makes an agent's write count as a person's.

Errors:

  • 400 validation_failed: name is missing or longer than 255 characters, body is missing or longer than 65,536 characters, description is longer than 2,000 characters, or authorSource is not user or agent.

Requires Inbox edit and the workspace_settings permission.

Request body

application/json, optional.

FieldTypeRequiredDescription
namestringrequiredRequired. The template's name, at most 255 characters. Kenso trims spaces at both ends.
descriptionstringoptionalA note on when to use the template, at most 2,000 characters. Omitted or blank saves none.
bodystringrequiredRequired. The reply body as HTML, at most 65,536 characters. Write variables as raw tokens such as {firstName}.
authorSourcestringoptionalOptional. agent records a person's template as written by an agent. user changes nothing: Kenso sets the author from the caller.
Request
curl -X POST "https://api.ken.so/v1/reply-templates" \
  -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 '{
  "name": "string",
  "description": "string",
  "body": "string",
  "authorSource": "string"
}'

Response 201

data is a ReplyTemplate.

Show the 8 response fields and an example

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

Get a reply template

GET/v1/reply-templates/{replyTemplateId}reply-templates.get
Permission
Inbox view
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

Returns one reply template.

Errors:

  • 404 not_found: no template in this workspace has this id.

Requires Inbox view.

Request
curl -X GET "https://api.ken.so/v1/reply-templates/812" \
  -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 ReplyTemplate.

Show the 8 response fields and an example

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

Update a reply template

PATCH/v1/reply-templates/{replyTemplateId}reply-templates.update
Permission
Inbox edit and the workspace_settings permission
Rate limit
4,800 requests a minute per API key

Try it on developer.ken.so

Changes the fields you send and keeps the rest. The body is a JSON object with any of name, description, body and authorSource, under the same rules as on create. Null description clears it. An empty object returns the template unchanged.

Kenso sets the author from the caller, as on create, so a person's edit records user and an agent's or API key's edit records agent, on a template a person wrote too.

Errors:

  • 400 validation_failed: a field breaks a create rule, or the body names an unknown field.
  • 404 not_found: no template in this workspace has this id.

Requires Inbox edit and the workspace_settings permission.

Request body

application/json, optional: object.

Request
curl -X PATCH "https://api.ken.so/v1/reply-templates/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 '{}'

Response 200

data is a ReplyTemplate.

Show the 8 response fields and an example

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

Delete a reply template

DELETE/v1/reply-templates/{replyTemplateId}reply-templates.delete
Permission
Inbox edit and the workspace_settings permission
Rate limit
4,800 requests a minute per API key

Try it on developer.ken.so

Deletes a reply template. Returns 204 with no body.

An agent or an API key may delete a template a person wrote.

Errors:

  • 400 validation_failed: authorSource is not user or agent.
  • 404 not_found: no template in this workspace has this id.

Requires Inbox edit and the workspace_settings permission.

Parameters

NameInTypeRequiredDescription
authorSourcequerystringoptionalOptional. agent deletes as an agent even when a person calls. user changes nothing.
Request
curl -X DELETE "https://api.ken.so/v1/reply-templates/812" \
  -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