---
title: "Update SMTP Configuration"
method: PATCH
path: "/api/organization/smtp"
tags: ["Organization"]
---

# Update SMTP Configuration

`PATCH /api/organization/smtp`

## Request

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

PATCH /api/organization/smtp

## Request body

- object
  - `disable` boolean
  - `host` string, nullable
  - `port` union: 1-65535; null or an empty string clears it.
    - integer
    - ''
  - `username` string, nullable
  - `password` string, nullable: Write-only; null clears it.
  - `tlsMode` 'ssl' | 'starttls' | 'none', nullable
  - `fromName` string, nullable
  - `fromEmail` string, email, nullable
  - `replyTo` string, email, nullable
  - `clearLastTest` boolean

## Response `200`

Successful response

- object
  - `smtp` object, required: All fields null while the organization sends through the platform.
    - `host` string, nullable, required
    - `port` integer, nullable, required
    - `username` string, nullable, required
    - `hasPassword` boolean, required: The password itself is never returned.
    - `tlsMode` 'ssl' | 'starttls' | 'none', nullable, required
    - `fromName` string, nullable, required
    - `fromEmail` string, nullable, required
    - `replyTo` string, nullable, required
    - `lastTestedAt` string, date-time, nullable, required
    - `lastTestStatus` string, nullable, required: success or error.
    - `lastTestError` string, nullable, required
    - `updatedAt` string, date-time, 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)