---
title: "Sets envelope notifications for an existing envelope."
method: PUT
path: "/v2.1/accounts/{accountId}/envelopes/{envelopeId}/notification"
tags: ["Envelopes"]
---

# Sets envelope notifications for an existing envelope.

`PUT /v2.1/accounts/{accountId}/envelopes/{envelopeId}/notification`

This method sets the notifications (reminders and expirations) for an existing envelope. The request body sends a structure containing reminders and expirations settings. It also specifies whether to use the settings specified in the request, or the account default notification settings for the envelope.

Note that this request only specifies when notifications are sent; it does not initiate sending of email messages.

## Path parameters

- `accountId` string, required
- `envelopeId` string, required

## Request body

- EnvelopeNotificationRequest — A complex element that specifies the notification settings for the envelope.
  - `expirations` Expirations — A complex element that specifies the expiration settings for the envelope. When an envelope expires, it is voided and no longer available for signing. **Note:** there is a short delay between when the envelope expires and when it is voided.
    - `expireAfter` string — An integer that sets the number of days the envelope is active. For this value to be used, `expireEnabled` must be explicitly set to **true.**
    - `expireEnabled` string — When **true,** the envelope expires in the number of days set by `expireAfter`. When **false** or not set, the envelope expires in the number of days specified by the [default expiration account setting](https://support.docusign.com/s/document-item?bundleId=pik1583277475390&topicId=rra1583277381176.html).
    - `expireWarn` string — An integer that specifying the number of days before the envelope expires that an expiration warning email is sent to the recipient. When 0 (zero), no warning email is sent.
  - `reminders` Reminders — A complex element that specifies reminder settings for the envelope.
    - `maximumReminderCount` string
    - `reminderDelay` string — An integer specifying the number of days after the recipient receives the envelope that reminder emails are sent to the recipient. The default value is 0.
    - `reminderEnabled` string — When **true,** reminders are enabled. The default value is **false.**
    - `reminderFrequency` string — An integer specifying the interval in days between reminder emails. The default value is 0.
    - `smartReminderEnabled` string
  - `useAccountDefaults` string — When **true,** the account default notification settings are used for the envelope, overriding the reminders and expirations settings. When **false,** the reminders and expirations settings specified in this request are used. The default value is **false.**

## Response `200`

Successful response.

## Other responses

- `400` — Error encountered.

---

[API](https://skmtc.net/docusign/apis/docusign-esignature-rest-api.md) · [All operations](https://skmtc.net/docusign/apis/docusign-esignature-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/docusign/docusign-esignature-rest-api/revisions/77f1998c313d/schema)