---
title: "Updates envelope notification default settings."
method: PUT
path: "/v2.1/accounts/{accountId}/settings/notification_defaults"
tags: ["Accounts"]
---

# Updates envelope notification default settings.

`PUT /v2.1/accounts/{accountId}/settings/notification_defaults`

This method changes the default settings for the email notifications that signers and senders receive about envelopes.

## Path parameters

- `accountId` string, required

## Request body

- NotificationDefaults
  - `apiEmailNotifications` NotificationDefaultSettings — Contains details about the default notification settings for the envelope notifications that senders and signers receive.
    - `senderEmailNotifications` SenderEmailNotifications — Contains the settings for the email notifications that senders receive about the envelopes that they send.
      - `changedSigner` string — When **true,** the sender receives an email notification if the signer changes.
      - `clickwrapResponsesLimitNotificationEmail` string
      - `commentsOnlyPrivateAndMention` string — When **true,** the user receives only comments that mention their own user name.
      - `commentsReceiveAll` string — When **true,** the user receives all comments.
      - `deliveryFailed` string — When **true,** the sender receives an email notification if envelope delivery fails.
      - `envelopeComplete` string — When **true,** the user receives an email notification when the envelope has been completed.
      - `offlineSigningFailed` string — When **true,** the user receives an email notification if offline signing failed.
      - `powerformResponsesLimitNotificationEmail` string
      - `purgeDocuments` string — When **true,** the user receives an email notification when a document purge occurs.
      - `recipientViewed` string — When **true,** the sender receives notification that a recipient viewed the envelope.
      - `senderEnvelopeDeclined` string — When **true,** the sender receives notification that the envelope was declined.
      - `withdrawnConsent` string — When **true,** the user receives an email notification if consent is withdrawn.
    - `signerEmailNotifications` SignerEmailNotifications — An array of email notifications that specifies the email the user receives when they are a recipient. When the specific email notification is set to true, the user receives those types of email notifications from Docusign. The user inherits the default account email notification settings when the user is created.
      - `agentNotification` string — When **true,** the user receives agent notification emails.
      - `carbonCopyNotification` string — When **true,** the user receives notifications of carbon copy deliveries.
      - `certifiedDeliveryNotification` string — When **true,** the user receives notifications of certified deliveries.
      - `commentsOnlyPrivateAndMention` string — When **true,** the user receives only comments that mention their own user name.
      - `commentsReceiveAll` string — When **true,** the user receives all comments.
      - `documentMarkupActivation` string — When **true,** the user receives notification that document markup has been activated.
      - `envelopeActivation` string — When **true,** the user receives notification that the envelope has been activated.
      - `envelopeComplete` string — When **true,** the user receives an email notification when the envelope has been completed.
      - `envelopeCorrected` string — When **true,** the user receives notification that the envelope has been corrected.
      - `envelopeDeclined` string — When **true,** the user receives notification that the envelope has been declined.
      - `envelopeVoided` string — When **true,** the user receives notification that the envelope has been voided.
      - `faxReceived` string — Reserved for Docusign.
      - `offlineSigningFailed` string — When **true,** the user receives an email notification if offline signing failed.
      - `purgeDocuments` string — When **true,** the user receives an email notification when a document purge occurs.
      - `reassignedSigner` string — When **true,** the user receives notification that the envelope has been reassigned.
      - `whenSigningGroupMember` string — When **true,** the user receives notification that he or she is a member of the signing group.
  - `emailNotifications` NotificationDefaultSettings — Contains details about the default notification settings for the envelope notifications that senders and signers receive.
    - `senderEmailNotifications` SenderEmailNotifications — Contains the settings for the email notifications that senders receive about the envelopes that they send.
      - `changedSigner` string — When **true,** the sender receives an email notification if the signer changes.
      - `clickwrapResponsesLimitNotificationEmail` string
      - `commentsOnlyPrivateAndMention` string — When **true,** the user receives only comments that mention their own user name.
      - `commentsReceiveAll` string — When **true,** the user receives all comments.
      - `deliveryFailed` string — When **true,** the sender receives an email notification if envelope delivery fails.
      - `envelopeComplete` string — When **true,** the user receives an email notification when the envelope has been completed.
      - `offlineSigningFailed` string — When **true,** the user receives an email notification if offline signing failed.
      - `powerformResponsesLimitNotificationEmail` string
      - `purgeDocuments` string — When **true,** the user receives an email notification when a document purge occurs.
      - `recipientViewed` string — When **true,** the sender receives notification that a recipient viewed the envelope.
      - `senderEnvelopeDeclined` string — When **true,** the sender receives notification that the envelope was declined.
      - `withdrawnConsent` string — When **true,** the user receives an email notification if consent is withdrawn.
    - `signerEmailNotifications` SignerEmailNotifications — An array of email notifications that specifies the email the user receives when they are a recipient. When the specific email notification is set to true, the user receives those types of email notifications from Docusign. The user inherits the default account email notification settings when the user is created.
      - `agentNotification` string — When **true,** the user receives agent notification emails.
      - `carbonCopyNotification` string — When **true,** the user receives notifications of carbon copy deliveries.
      - `certifiedDeliveryNotification` string — When **true,** the user receives notifications of certified deliveries.
      - `commentsOnlyPrivateAndMention` string — When **true,** the user receives only comments that mention their own user name.
      - `commentsReceiveAll` string — When **true,** the user receives all comments.
      - `documentMarkupActivation` string — When **true,** the user receives notification that document markup has been activated.
      - `envelopeActivation` string — When **true,** the user receives notification that the envelope has been activated.
      - `envelopeComplete` string — When **true,** the user receives an email notification when the envelope has been completed.
      - `envelopeCorrected` string — When **true,** the user receives notification that the envelope has been corrected.
      - `envelopeDeclined` string — When **true,** the user receives notification that the envelope has been declined.
      - `envelopeVoided` string — When **true,** the user receives notification that the envelope has been voided.
      - `faxReceived` string — Reserved for Docusign.
      - `offlineSigningFailed` string — When **true,** the user receives an email notification if offline signing failed.
      - `purgeDocuments` string — When **true,** the user receives an email notification when a document purge occurs.
      - `reassignedSigner` string — When **true,** the user receives notification that the envelope has been reassigned.
      - `whenSigningGroupMember` string — When **true,** the user receives notification that he or she is a member of the signing group.

## 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/versions/77f1998c313d/schema)