---
title: "Update email settings"
method: PATCH
path: "/settings/email/{id}"
tags: ["Email Settings"]
---

# Update email settings

`PATCH /settings/email/{id}`

## Request

- Base URL: `https://www.virustotal.com/api/v3/dtm`
- URL: `https://www.virustotal.com/api/v3/dtm/settings/email/{id}`
- Auth: none required

## Path parameters

- `id` string, required

## Headers

- `x-apikey` string, required
- `Accept` 'application/json'
- `Content-Type` 'application/json', required

## Request body

- EmailSetting: Email notification settings.
  - `created_at` string, date-time: The timestamp this email setting was created.
  - `delivery_times` string[]: The delivery times specified for scheduled emails.
  - `frequency` string[]: The frequency at which scheduled emails are delivered.
  - `id` string: The ID of the email settings.
  - `recipients` EmailRecipient[]: The recipients to receive emails.
    - `email_address` string, email, required: The email address of the recipient.
    - `status` 'invalid' | 'pending' | 'verified' | 'expired': The status of the email address verification.
    - `verification_sent_at` string, date-time: The timestamp an email verification was sent at for this email address.
  - `timezone_location` string: The timezone location to use for scheduled emails.
  - `updated_at` string, date-time: The timestamp this email setting was last updated.

## Response `200`

OK

- EmailSetting: Email notification settings.
  - `created_at` string, date-time: The timestamp this email setting was created.
  - `delivery_times` string[]: The delivery times specified for scheduled emails.
  - `frequency` string[]: The frequency at which scheduled emails are delivered.
  - `id` string: The ID of the email settings.
  - `recipients` EmailRecipient[]: The recipients to receive emails.
    - `email_address` string, email, required: The email address of the recipient.
    - `status` 'invalid' | 'pending' | 'verified' | 'expired': The status of the email address verification.
    - `verification_sent_at` string, date-time: The timestamp an email verification was sent at for this email address.
  - `timezone_location` string: The timezone location to use for scheduled emails.
  - `updated_at` string, date-time: The timestamp this email setting was last updated.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/virustotal/apis/dtm-digital-threat-monitoring.md) - [All operations](https://skmtc.dev/virustotal/apis/dtm-digital-threat-monitoring/llms.txt) - [OpenAPI document](https://skmtc.dev/virustotal/apis/dtm-digital-threat-monitoring/revisions/ba27db660651?raw)