---
title: "Creates custom document fields in an existing template document."
method: POST
path: "/v2.1/accounts/{accountId}/templates/{templateId}/custom_fields"
tags: ["TemplateCustomFields"]
---

# Creates custom document fields in an existing template document.

`POST /v2.1/accounts/{accountId}/templates/{templateId}/custom_fields`

## Request

- Base URL: `https://www.docusign.net/restapi`
- URL: `https://www.docusign.net/restapi/v2.1/accounts/{accountId}/templates/{templateId}/custom_fields`
- Auth: none declared

Creates custom document fields in an existing template document.

## Path parameters

- `accountId` string, required
- `templateId` string, required

## Request body

- TemplateCustomFields
  - `listCustomFields` ListCustomField[]: An array of list custom fields.
    - `configurationType` string: If you are using merge fields, this property specifies the type of the merge field. The only supported value is `salesforce`.
    - `errorDetails` ErrorDetails: This object describes errors that occur. It is only valid for responses and ignored in requests.
      - `errorCode` string: The code associated with the error condition.
      - `message` string: A brief message describing the error condition.
    - `fieldId` string: The ID of the custom field.
    - `listItems` string[]: An array of strings that represents the options in a list. Maximum length: 2048 characters, but each individual option string can only be a maximum of 100 characters.
    - `name` string: The name of the custom field.
    - `required` string: When **true,** senders are required to select an option from the list before they can send the envelope.
    - `show` string: When **true,** the field displays in the **Envelope Custom Fields** section when a user creates or sends an envelope.
    - `value` string: The value of the custom field. This is the value that the user who creates or sends the envelope selects from the list.
  - `textCustomFields` TextCustomField[]: An array of text custom fields.
    - `configurationType` string: If you are using merge fields, this property specifies the type of the merge field. The only supported value is `salesforce`.
    - `errorDetails` ErrorDetails: This object describes errors that occur. It is only valid for responses and ignored in requests.
      - `errorCode` string: The code associated with the error condition.
      - `message` string: A brief message describing the error condition.
    - `fieldId` string: The ID of the custom field.
    - `name` string: The name of the custom field.
    - `required` string: When **true,** senders are required to enter or select information for the field before they can send the envelope.
    - `show` string: When **true,** the field displays in the **Envelope Custom Fields** section when a user creates or sends an envelope.
    - `value` string: The value of the custom field. The user who creates or sends the envelope provides this value. Maximum length: 100 characters.

## Response `201`

Successful response.

## Other responses

- `400`: Error encountered.

---

[API](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api.md) - [All operations](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api/revisions/77f1998c313d?raw)