Update account custom field

PUT

/v2.1/accounts/:accountId/custom_fields/:customFieldId

PUT

/restapi/v2.1/accounts/:accountId/custom_fields/:customFieldId

curl -X PUT https://demo.docusign.net/restapi/v2.1/accounts/ACCOUNT_ID/custom_fields/CUSTOM_FIELD_ID \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "customFieldType": "sample string 1",
  "errorDetails": {
    "errorCode": "sample string 1",
    "message": "sample string 2"
  },
  "fieldId": "sample string 2",
  "listItems": [
    "sample string 1"
  ],
  "name": "sample string 3",
  "required": "sample string 4",
  "show": "sample string 5",
  "value": "sample string 6"
}'

{
  "listCustomFields": [
    {
      "configurationType": "sample string 1",
      "errorDetails": {
        "errorCode": "sample string 1",
        "message": "sample string 2"
      },
      "fieldId": "sample string 2",
      "listItems": [
        "sample string 1"
      ],
      "name": "sample string 3",
      "required": "sample string 4",
      "show": "sample string 5",
      "value": "sample string 6"
    }
  ],
  "textCustomFields": [
    {
      "configurationType": "sample string 1",
      "fieldId": "sample string 2",
      "name": "sample string 3",
      "required": "sample string 4",
      "show": "sample string 5",
      "value": "sample string 6"
    }
  ]
}

This method updates an existing account custom field.

Authentication

AuthorizationBearer

OAuth 2.0 access token (JWT or auth-code grant). Sent as Authorization: Bearer <token> on every request except GET /v2.1 and GET /service_information, which are public discovery endpoints.

Path parameters

accountIdstringRequired

The external account number (int) or account ID Guid.

customFieldIdstringRequired

The ID of the custom field.

Query parameters

apply_to_templatesstringOptional

Request

This endpoint expects an object: customField

customFieldTypestringOptional

The type of custom field. Valid values are:

text (default)
list

errorDetailsobjectOptional

This object describes errors that occur. It is only valid for responses, and ignored in requests.

fieldIdstringOptional

The ID of the custom field.

listItemslist of stringsOptional

For a list custom field, this is an array of strings that represent the items in a list.

Maximum Length: 2,000 characters.

namestringOptional

The name of the custom field.

requiredstringOptional

When true, the signer must complete the custom field.

showstringOptional

When true, the custom field displays at the top of the Certificate of Completion.

valuestringOptional

Specifies the value of the custom field.

Maximum Length: 2,000 characters.

Response

Successful response.

listCustomFieldslist of objectsOptional

An array of list custom fields.

textCustomFieldslist of objectsOptional

An array of text custom fields.

Errors

400

Bad Request Error