---
title: "Create a new document from an existing template"
method: POST
path: "/api/v1/templates/{templateId}/create-document"
deprecated: true
---

# Create a new document from an existing template

`POST /api/v1/templates/{templateId}/create-document`

> **Deprecated.**

This endpoint is deprecated, but will continue to be supported. For more details, see https://docs.documenso.com/developers/public-api. 

If you must use the V1 API, use "/api/v1/templates/:templateId/generate-document" instead.

## Path parameters

- `templateId` string, required

## Headers

- `authorization` string, required

## Request body

- object
  - `title` string, required
  - `externalId` string, nullable
  - `recipients` object[], required
    - `name` string, required
    - `email` string, email, required
    - `role` 'CC' | 'SIGNER' | 'VIEWER' | 'APPROVER' | 'ASSISTANT'
    - `signingOrder` number, nullable
  - `meta` object
    - `subject` string
    - `message` string
    - `timezone` string
    - `dateFormat` string
    - `redirectUrl` string
    - `signingOrder` 'PARALLEL' | 'SEQUENTIAL'
    - `allowDictateNextSigner` boolean
    - `language` 'de' | 'en' | 'fr' | 'es' | 'it' | 'nl' | 'pl' | 'pt-BR' | 'ja' | 'ko' | 'zh'
  - `authOptions` object
    - `globalAccessAuth` union
      - 'ACCOUNT' | 'TWO_FACTOR_AUTH' — The type of authentication required for the recipient to access the document.
      - string[]
    - `globalActionAuth` union
      - 'ACCOUNT' | 'PASSKEY' | 'TWO_FACTOR_AUTH' | 'PASSWORD' — The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only.
      - string[]
  - `formValues` object
  - `attachments` object[]
    - `label` string, required
    - `data` string, uri, required
    - `type` 'link'

## Response `200`

200

- object
  - `documentId` number, required
  - `externalId` string, nullable
  - `recipients` object[], required
    - `recipientId` number, required
    - `name` string, required
    - `email` string, email, required
    - `token` string, required
    - `role` 'CC' | 'SIGNER' | 'VIEWER' | 'APPROVER' | 'ASSISTANT'
    - `signingOrder` number, nullable
    - `signingUrl` string, required

## Other responses

- `401` — 401
- `404` — 404

---

[API](https://skmtc.dev/kpitaljobs/apis/documenso-api.md) · [All operations](https://skmtc.dev/kpitaljobs/apis/documenso-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kpitaljobs/apis/documenso-api/revisions/fafcd949413a?raw)