---
title: "Test SMTP"
method: POST
path: "/api/organization/smtp/test"
tags: ["Organization"]
---

# Test SMTP

`POST /api/organization/smtp/test`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/organization/smtp/test`
- Auth: HTTP bearer

## Request body

- object
  - `toEmail` string, email: Default: the caller.
  - `subject` string
  - `message` string
  - `host` string, nullable
  - `port` union: 1-65535; null or an empty string clears it.
    - integer
    - ''
  - `username` string, nullable
  - `password` string, nullable
  - `tlsMode` 'ssl' | 'starttls' | 'none', nullable
  - `fromName` string, nullable
  - `fromEmail` string, email, nullable
  - `replyTo` string, email, nullable

## Response `200`

Successful response

- object
  - `success` true, required
  - `messageId` string, nullable, required

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)
