---
title: "Update my notification preferences"
method: PUT
path: "/v1/users/self/notification-preferences"
tags: ["Users"]
---

# Update my notification preferences

`PUT /v1/users/self/notification-preferences`

Merges the supplied map into the authenticated user's preferences. Send only the keys you want to change — omitted keys keep their current value. Setting a key to `false` stops that e-mail for this user in every account they belong to. Returns the full map. An unknown code, a non-boolean value, or an empty body is rejected with 400 and nothing is written.

[Copy as Markdown](https://api.assinafy.com.br/v1/docs/markdown?method=put&path=%2Fv1%2Fusers%2Fself%2Fnotification-preferences) [Open in ChatGPT](https://chatgpt.com/?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dput%26path%3D%252Fv1%252Fusers%252Fself%252Fnotification-preferences%20and%20help%20me%20integrate%20this%20endpoint.) [Open in Claude](https://claude.ai/new?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dput%26path%3D%252Fv1%252Fusers%252Fself%252Fnotification-preferences%20and%20help%20me%20integrate%20this%20endpoint.)

## Request body

- NotificationPreferences — Owner-facing document notifications, keyed by notification type. `true` means the e-mail is sent.
  - `DocumentCompleted` boolean — Every signer has signed and the document is certified.
  - `SignerDeclined` boolean — A signer declined to sign.
  - `DocumentCancelled` boolean — The document was cancelled.
  - `DocumentAboutToExpire` boolean — The signature deadline is approaching.
  - `DocumentExpired` boolean — The signature deadline passed.
  - `DocumentExpirationReset` boolean — The signature deadline was extended.
  - `DocumentProcessingFailed` boolean — An uploaded document could not be processed.
  - `TemplateProcessingFailed` boolean — A template could not be processed.
  - `SignerWhatsappFailed` boolean — A WhatsApp notification to a signer could not be delivered.

## Response `200`

The updated preferences

- object — Standard success wrapper. Operations add their own `data`.
  - `status` integer — HTTP status code, mirrored in the body.
  - `message` string — Human-readable message; empty on success.
  - `data` NotificationPreferences — Owner-facing document notifications, keyed by notification type. `true` means the e-mail is sent.
    - `DocumentCompleted` boolean — Every signer has signed and the document is certified.
    - `SignerDeclined` boolean — A signer declined to sign.
    - `DocumentCancelled` boolean — The document was cancelled.
    - `DocumentAboutToExpire` boolean — The signature deadline is approaching.
    - `DocumentExpired` boolean — The signature deadline passed.
    - `DocumentExpirationReset` boolean — The signature deadline was extended.
    - `DocumentProcessingFailed` boolean — An uploaded document could not be processed.
    - `TemplateProcessingFailed` boolean — A template could not be processed.
    - `SignerWhatsappFailed` boolean — A WhatsApp notification to a signer could not be delivered.

## Other responses

- `400` — One or more fields failed validation.
- `401` — Missing or invalid credentials.
- `500` — Unexpected server error.

---

[API](https://skmtc.dev/assinafy/apis/assinafy-api-reference.md) · [All operations](https://skmtc.dev/assinafy/apis/assinafy-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/assinafy/assinafy-api-reference/revisions/f479941d10e9/schema)