> For the complete documentation index, see [llms.txt](https://developers.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.docstudio.com/api-reference/create-template.md). # Create Template This document contains details for the /api/v1/template endpoint, including headers, request body, response fields, and status codes. ### Endpoint | Property | Value | | -------- | ------------------ | | Method | `POST` | | URL | `/api/v1/template` | ### Headers | Header | Required | Description | | --------------- | -------- | -------------------------- | | `Authorization` | Yes | Bearer authorization token | | `Content-Type` | Yes | `application/json` | | `mailboxUuid` | Yes | Target mailbox UUID | ```http Authorization: Bearer {token} Content-Type: application/json mailboxUuid: {mailboxUuid} ``` ### Request body
FieldTypeRequiredDescription
accessstringYesTemplate access level, such as mailbox
categoriesarrayYesCategory IDs, or an empty array
datastringYesTemplate XML serialized as a JSON string
### Request example ```http POST /api/v1/template Authorization: Bearer {token} Content-Type: application/json mailboxUuid: 9baec31c-e940-4894-b6d1-52033e1af66e ``` ```json { "access": "mailbox", "categories": [], "data": "" } ``` ### Response | Field | Type | Description | | --------- | ---- | ----------------------------- | | `uuid` | UUID | Created template UUID | | `version` | UUID | Created template version UUID | ### Response example ```json { "uuid": "56cacd6a-ffe7-4b77-9c0c-f928d9a18cb5", "version": "ab0d11cb-ebdd-42bd-a581-ddca1bb9b585" } ``` ### Status codes
CodeDescription
200Success. The response contains the template UUID and version
401Missing, invalid, or expired authorization token
403Authenticated user cannot create templates in the target mailbox
### Related topics * [Send Envelope](/api-reference/send-envelope.md) * [Fill Envelope](/api-reference/fill-envelope.md)