---
title: "Test credentials (no save)"
method: POST
path: "/mailboxes/test"
tags: ["Mailboxes"]
---

# Test credentials (no save)

`POST /mailboxes/test`

## Request

- Base URL: `https://warmysender.com/api/v1`
- URL: `https://warmysender.com/api/v1/mailboxes/test`
- Auth: HTTP bearer

Synchronously tests SMTP + IMAP credentials WITHOUT creating a mailbox. Rate limited.

Required scope: `mailboxes:write`.

Subject to a stricter per-endpoint connection-test rate limit (in addition to the workspace-wide per-minute limit for your plan — Pro 60 · Enterprise 240 · Ultimate 480).

port_corrected and original_port appear only when an SMTP port fallback succeeded.

## Request body

- object
  - `email_address` string, email, required: The mailbox email address.
  - `smtp_host` string, required: SMTP server hostname, e.g. smtp.gmail.com.
  - `smtp_port` integer: SMTP port. One of 25, 465, 587. Defaults to 587.
  - `smtp_username` string, required: SMTP login (usually the email address).
  - `smtp_password` string, password, required: SMTP password or app password.
  - `imap_host` string, required: IMAP server hostname, e.g. imap.gmail.com.
  - `imap_port` integer: IMAP port. One of 143, 993. Defaults to 993.
  - `imap_username` string, required: IMAP login (usually the email address).
  - `imap_password` string, password, required: IMAP password or app password.

## Response `200`

Success

## Other responses

- `400`: `validation_error` — Body failed validation.
- `401`: `unauthorized` — Missing or invalid API key.
- `403`: `insufficient_scope` — The API key lacks the scope this endpoint requires.
- `422`: `ssrf_blocked` — A host resolved to a private/internal IP.
- `429`: `rate_limited` — Too many requests — slow down and retry after the Retry-After delay.

---

[API](https://skmtc.dev/warmysender/apis/warmysender-public-api.md) · [All operations](https://skmtc.dev/warmysender/apis/warmysender-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/warmysender/apis/warmysender-public-api/revisions/eb5c7f10a1cd?raw)