Templates: updateNotificationSettings

Updates the notification structure for an existing template. Use this endpoint to set reminder and expiration notifications.

Request

HTTP request

PUT /v2/accounts/{accountId}/templates/{templateId}/notification

Parameters

Parameter NameValueDescription
Path Parameters
accountIdstring

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

templateIdstring

The ID of the template being accessed.

Responses

CodeDescriptionReference
200

Successful response.

notification
400

Error encountered.

errorDetails

SDK Method

Templates::updateNotificationSettings

Definitions

errorDetails

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

errorCodestring

An error code associated with the error.

messagestring

A short error message.

expirations

A complex element that specifies the expiration settings for the envelope.

expireAfterstring

An integer that sets the number of days the envelope is active.

expireEnabledstring

When set to true, the envelope expires (is no longer available for signing) in the set number of days. If false, the account default setting is used. If the account does not have an expiration setting, the DocuSign default value of 120 days is used.

expireWarnstring

An integer that sets the number of days before envelope expiration that an expiration warning email is sent to the recipient. If set to 0 (zero), no warning email is sent.

notification

A complex element that specifies the notification options for the envelope. It consists of:

  • useAccountDefaults - When set to true, the account default notification settings are used for the envelope.
  • reminders - A complex element that specifies reminder settings for the envelope. It consists of:

    • reminderEnabled - When set to true, a reminder message is sent to the recipient.
    • reminderDelay - An interger that sets the number of days after the recipient receives the envelope that reminder emails are sent to the recipient.
    • reminderFrequency - An interger that sets the interval, in days, between reminder emails.
  • expirations - A complex element that specifies the expiration settings for the envelope. It consists of:

    • expireEnabled - When set to true, the envelope expires (is no longer available for signing) in the set number of days. If false, the account default setting is used. If the account does not have an expiration setting, the DocuSign default value of 120 days is used.
    • expireAfter - An integer that sets the number of days the envelope is active.
    • expireWarn - An integer that sets the number of days before envelope expiration that an expiration warning email is sent to the recipient. If set to 0 (zero), no warning email is sent.

expirationsexpirations

A complex element that specifies the expiration settings for the envelope.

remindersreminders

A complex element that specifies reminder settings for the envelope

useAccountDefaultsstring

When set to true, the account default notification settings are used for the envelope.

reminders

A complex element that specifies reminder settings for the envelope

reminderDelaystring

An interger that sets the number of days after the recipient receives the envelope that reminder emails are sent to the recipient.

reminderEnabledstring

When set to true, the envelope expires (is no longer available for signing) in the set number of days. If false, the account default setting is used. If the account does not have an expiration setting, the DocuSign default value of 120 days is used.

reminderFrequencystring

An interger that sets the interval, in days, between reminder emails.

templateNotificationRequest

expirationsexpirations

A complex element that specifies the expiration settings for the envelope.

passwordstring

remindersreminders

A complex element that specifies reminder settings for the envelope

useAccountDefaultsstring

When set to true, the account default notification settings are used for the envelope.

Examples

Generic JSON Request/Response

Request
{
  "password": "sample string 1",
  "useAccountDefaults": "sample string 2",
  "reminders": {
    "reminderEnabled": "sample string 1",
    "reminderDelay": "sample string 2",
    "reminderFrequency": "sample string 3"
  },
  "expirations": {
    "expireEnabled": "sample string 1",
    "expireAfter": "sample string 2",
    "expireWarn": "sample string 3"
  }
}
Response
{
  "useAccountDefaults": "sample string 1",
  "reminders": {
    "reminderEnabled": "sample string 1",
    "reminderDelay": "sample string 2",
    "reminderFrequency": "sample string 3"
  },
  "expirations": {
    "expireEnabled": "sample string 1",
    "expireAfter": "sample string 2",
    "expireWarn": "sample string 3"
  }
}
Generic XML Request/Response

Request
<notification xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.docusign.com/restapi">
  <expirations>
    <expireAfter>sample string 2</expireAfter>
    <expireEnabled>sample string 1</expireEnabled>
    <expireWarn>sample string 3</expireWarn>
  </expirations>
  <reminders>
    <reminderDelay>sample string 2</reminderDelay>
    <reminderEnabled>sample string 1</reminderEnabled>
    <reminderFrequency>sample string 3</reminderFrequency>
  </reminders>
  <useAccountDefaults>sample string 2</useAccountDefaults>
  <password>sample string 1</password>
</notification> 
Response
<notification xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.docusign.com/restapi">
  <expirations>
    <expireAfter>sample string 2</expireAfter>
    <expireEnabled>sample string 1</expireEnabled>
    <expireWarn>sample string 3</expireWarn>
  </expirations>
  <reminders>
    <reminderDelay>sample string 2</reminderDelay>
    <reminderEnabled>sample string 1</reminderEnabled>
    <reminderFrequency>sample string 3</reminderFrequency>
  </reminders>
  <useAccountDefaults>sample string 1</useAccountDefaults>
</notification> 
}} />