---
title: "POST /api/v1/instance/settings/notification:testEmail"
method: POST
path: "/api/v1/instance/settings/notification:testEmail"
tags: ["InstanceService"]
---

# POST /api/v1/instance/settings/notification:testEmail

`POST /api/v1/instance/settings/notification:testEmail`

Tests notification email delivery with the provided or stored SMTP settings.

## Request body

- TestInstanceEmailSettingRequest — Request message for TestInstanceEmailSetting method.
  - `email` NotificationSettingEmailSetting — Email delivery configuration for notifications.
    - `enabled` boolean
    - `smtpHost` string
    - `smtpPort` integer
    - `smtpUsername` string
    - `smtpPassword` string
    - `fromEmail` string
    - `fromName` string
    - `replyTo` string
    - `useTls` boolean
    - `useSsl` boolean
  - `recipientEmail` string — Optional. Recipient email address. If omitted, the current user's email address is used.

## Response `200`

OK

## Other responses

- `default` — Default error response

## Changes

- **2026-05-01** `a9500af59bdd` — 1 info
  - endpoint added
- **2025-12-15** `d740073f088f` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/usememos/apis/untitled-api/changes/api/v1/instance/settings/notification:testEmail/post.md)

---

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