**Source URL:** https://general.veevavault.dev/regulatory/vault-api/api-reference/26.1/documents/document-templates/create-single-document-template.md

# Create Single Document Template



Create one basic document template. To create multiple document templates, see [Create Multiple Document Templates](/vault-api/api-reference/26.1/documents/document-templates/create-multiple-document-templates).

You cannot create templates if your Vault exceeds template limits. Learn more about [document template limits in Vault Help](https://platform.veevavault.help/en/gr/5509/#limits).

<Endpoint path="/api/{version}/objects/documents/templates" method="POST"></Endpoint>

## Headers {#headers}

| Name | Description |
| --- | --- |
| `Content-Type` | `multipart/form-data` |
| `Accept` | `application/json` (default) or `application/xml` |

#### Body Parameters: Basic Document Template {#body-parameters-basic-document-template}

When creating basic document templates, the following fields are required in all Vaults:

<FieldTable>
| Name | Description |
| --- | --- |
| `name__v` | The name of the new document template. If not included, Vault will use the specified `label__v` value to generate a value for the `name__v` field. |
| `label__v` | The label of the new document template. This is the name users will see among the available templates in the UI. |
| `type__v` | The name of the document type to which the template will be associated. |
| `subtype__v` | The name of the document subtype to which the template will be associated. This is only required if associating the template with a document subtype. |
| `classification__v` | The name of the document classification to which the template will be associated. This is only required if associating the template with a document classification. |
| `active__v` | Set to true or false to indicate whether or not the new document template should be set to active, i.e., available for selection when creating a document. |
| `file` | The filepath of the file for this document template. Maximum allowed size is 4GB. |
</FieldTable>

## Request {#request}

<CodeExample title="">
```
curl -X POST -H "Authorization: {SESSION_ID}" \
-H "Content-Type: multipart/form-data" \
-H "Accept: text/csv" \
-F "file=Promo Ad Template.docx" \
-F "label__v=Promo Ad Template" \
-F "type__v=promotional_piece__c" \
-F "subtype__v=advertisement__c" \
-F "classification__v=print__c" \
-F "active__v=true" \
https://myvault.veevavault.com/api/v15.0/objects/documents/templates

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
responseStatus,name,errors
SUCCESS,promo_ad_template__c,

```
</CodeExample>

---

**Previous:** [Download Document Template File](/regulatory/vault-api/api-reference/26.1/documents/document-templates/download-document-template-file)  
**Next:** [Create Multiple Document Templates](/regulatory/vault-api/api-reference/26.1/documents/document-templates/create-multiple-document-templates)