---
title: "Create Template"
method: POST
path: "/voice/api/v1/template"
tags: ["templates"]
---

# Create Template

`POST /voice/api/v1/template`

Create a custom note template. Describe the exact structure, sections and style you want in `desc` using plain text or markdown — for example "SOAP note with Subjective, Objective, Assessment, Plan; use bullet points; include a medication table". EkaScribe uses this description as the authoring instruction when generating notes. Pass the returned `template_id` in Create Session (`templates`) or Process Template.

## Request body

- TemplateCreateRequest
  - `title` string, required — Display name of the template.
  - `desc` string — The template instructions in plain text or markdown. Describe the sections, ordering, formatting (bullets, tables, headings) and tone you want in the generated note. This is what EkaScribe follows when generating notes with this template.
  - `section_ids` string[], required — Pass an empty array `[]`. Describe your desired structure in `desc` instead.
  - `type` string — Template type. Use `custom` (default) for your own templates.

## Response `201`

Template created

- TemplateCreateResponse
  - `msg` string
  - `template_id` string

## Other responses

- `401` — Authentication failed
- `422` — Validation error

---

[API](https://skmtc.net/eka/apis/eka-developer-apis.md) · [All operations](https://skmtc.net/eka/apis/eka-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eka/eka-developer-apis/revisions/9ea23456f722/schema)