---
title: "Create email settings"
method: POST
path: "/settings/email"
tags: ["Email Settings"]
---

# Create email settings

`POST /settings/email`

## Headers

- `x-apikey` string, required
- `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.net/virustotal/apis/threat-landscape.md) · [All operations](https://skmtc.net/virustotal/apis/threat-landscape/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/virustotal/threat-landscape/versions/d61b85e6a6b3/schema)