> 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-documentation/api-methods/create-template.md). # Create Template ### Method
MethodPOST
URL/api/v1/template
AuthorizationBearer {token}
Content-Typeapplication/json
Mailbox UUID header{uuid}
Body{"access":"string","categories":[],"data":"string"}
Use this endpoint to create a template from XML. Send the template XML as a string inside the `data` field and pass the target mailbox in the `mailboxUuid` header. ### How it works Build the template as XML first. Then send that XML inside the JSON body. The response returns the template UUID and version. Reuse those values later in envelope requests. Reuse the same role IDs, document IDs, and field names from the template structure. ### Request body Use these body fields: * `access` — template access level, such as `mailbox` * `categories` — category IDs, or an empty array * `data` — template XML string ```json { "access": "mailbox", "categories": [], "data": "template XML string" } ``` #### Template example This simplified template example shows the XML that goes inside the `data` field. ```xml ``` Use template fields to define which data recipients must fill or sign. ### Response example ```json { "uuid": "56cacd6a-ffe7-4b77-9c0c-f928d9a18cb5", "name": "Template name", "description": "Template description", "data": "...", "version": "ab0d11cb-ebdd-42bd-a581-ddca1bb9b585", "dataCreatedAt": "2020-12-02T06:30:44.543Z", "dataModifiedAt": "2020-12-02T06:30:44.543Z", "access": "mailbox", "archive": false, "categories": [], "createdAt": "2020-12-02T06:30:44.503Z", "modifiedAt": "2020-12-02T06:30:44.503Z" } ``` Pay attention to `uuid` and `version`. Use them in [Send Envelope](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/envelope/send-envelope) and [Fill Envelope](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/envelope/fill-envelope). ### Related topics * [Template Structure API](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/template-api/template-structure-api) * [Template API](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/template-api) * [Send Envelope](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/envelope/send-envelope) * [Fill Envelope](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/envelope/fill-envelope)