---
title: "Welcome Email"
method: POST
path: "/api/auth/welcome-email"
tags: ["auth"]
---

# Welcome Email

`POST /api/auth/welcome-email`

## Request

- Base URL: `https://api.maritime.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maritime.sh/api/auth/welcome-email`
- Auth: none declared

Trigger the one-time welcome email for a newly registered account.

Called by the frontend on a first-ever OAuth sign-in (email/password
signups get theirs from /verify-email instead). Safe to expose
unauthenticated: the service only mails an address the user provably
owns (OAuth Account row or verified email), the welcomeEmailSentAt
claim makes it once-ever per account, and every pre-existing account
was stamped at migration time. Always returns ok (enumeration-safe).

## Request body

- WelcomeEmailRequest: Request schema for triggering the one-time welcome email.
  - `email` string, email, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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