---
title: "Create a template"
method: POST
path: "/e-signature-templates"
tags: ["ESignature Templates"]
---

# Create a template

`POST /e-signature-templates`

## Request

- Base URL: `https://rest.api.pactima.com/v1`
- URL: `https://rest.api.pactima.com/v1/e-signature-templates`
- Auth: HTTP bearer

Creates an eSignature template

## Request body

- object
  - `title` string, required: The title of the eSignature template.
  - `description` string: Description of of the eSignature template.
  - `emailMessage` string: Template of email message body to be sent to the signers.
  - `owner` string: Snapdocs RON (formerly Pactima) ID of the owner of the package. Defaults to the id of the requester; when using as Team Integration API Key, the request can specify any team member
  - `kind` 'REGULAR' | 'EASY_SIGN'
  - `orderedSigners` boolean: Determine if signers are ordered
  - `customBrandItemId` string: ID of the custom brand item to use for the package. Owner must have own the specified the custom brand item.

## Response `200`

Returns the object if it was successfully created.

- ESignatureTemplate
  - `id` string, required
  - `isTestMode` boolean
  - `title` string, required
  - `description` string
  - `emailMessage` string
  - `documents` ESignatureTemplateDocument[]
    - `id` string
    - `name` string
    - `pageCount` number
    - `entryPads` ESignatureEntryPad[]
      - `id` string
      - `signerId` string, required: Id of the signer
      - `type` 'signature' | 'initials' | 'stamp' | 'date' | 'text' | 'checkbox' | 'name' | 'notary_public_profile_info' | 'email', required
      - `left` number, required: Offset from the left. Must be between 0 and 100. Units of measure is the percentage relative to the width of the containing page.
      - `top` number, required: Offset from the top. Must be between 0 and 100. Units of measure is the percentage relative to the width of the containing page.
      - `height` number, required: Height of the entry pad. Must be between 0 and 100. Units of measure is the percentage relative to the width of the containing page.
      - `width` number, required: Width of the entry pad. Must be between 0 and 100. Units of measure is the percentage relative to the width of the containing page.
      - `pageIndex` number, required: Page index whereby the entry pad is contained in the document.
      - `isOptional` boolean: Set to true if the entry pad is optional.
      - `metadata` unknown
  - `signers` ESignatureTemplateSigner[]
    - `id` string, required
    - `name` string, required
    - `attachmentRequests` ESignatureSignerAttachmentRequest[]
      - `id` string
      - `name` string, required
      - `description` string
      - `isOptional` boolean: Set to true if the request is optional
      - `isConfidential` boolean: Set to true if the attachment should not be shared with other signers; only the owner
    - `specialRoles` ESignatureSignerSpecialRoleEnum[]
    - `viewRestrictions` ESignatureSignerViewRestrictionEnum[]
  - `ccRecipients` ESignatureTemplateRecipient[]
    - `id` string, required
    - `name` string, required
  - `orderedSigners` boolean: Signers are sent by order
  - `owner` string
  - `kind` 'REGULAR' | 'EASY_SIGN'
  - `packageFolderId` string: Package folder that the esp is part of
  - `customBrandItemId` string: Id of the applicable custom brand item to apply to this eSignature template
  - `customBrandItem` CustomBrandItem
    - `id` string
    - `ownerId` string: Public id of the owner
    - `name` string, required: Name of the custom brand item
    - `logoSrc` string, required: Url of the logo
    - `isDefault` boolean: Mark whether the default is default
    - `emailNotification` CustomBrandItemEmailNotification
      - `senderName` string, required: The name that is sent when an email from Snapdocs RON (formerly Pactima) is sent out. Placeholders {{firstName}} and {{lastName}} can be used
      - `colorTheme` object, required
        - `headerBackground` string, required
        - `headerText` string, required
        - `buttonBackground` string, required
        - `buttonText` string, required
        - `linkColor` string, required
    - `signingCeremony` CustomBrandItemSigningCeremony, required
      - `colorTheme` object, required
        - `headerBackground` string, required
        - `buttonBackground` string, required
        - `buttonText` string, required
    - `whiteLabelConfig` CustomBrandItemWhiteLabelConfig
      - `domainNames` string[]
      - `rootCSS` object
      - `notificationEmailAddress` string, email
      - `footerDetails` object
        - `inlineItems` string[]
        - `copyrightItem` string, html
      - `pathsConfig` object
        - `basePath` string
        - `basePathAuthenticated` string
  - `ownerDetails` OwnerDetails
    - `firstName` string
    - `lastName` string
    - `publicId` string
    - `email` string
  - `allTemplateFields` ESignatureTemplateField[]
    - `name` string, required
    - `required` boolean

---

[API](https://skmtc.dev/pactima/apis/esignature-templates-api.md) - [All operations](https://skmtc.dev/pactima/apis/esignature-templates-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pactima/apis/esignature-templates-api/revisions/7d2bb0c7b4b9?raw)