---
title: "Post Email"
method: POST
path: "/api/account/email"
tags: ["account"]
---

# Post Email

`POST /api/account/email`

## Request

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

Ask for a new address: a confirmation goes to it, and nothing changes
until its button is pressed (`/email/confirm`). The password where the
account has one, a current code where the second factor is on.

`sent` whatever became of it — the address free and mailed, another
account's, the account's own, declined, or over the throttle — as en.ts
`account.emailChangeSent` words it ("If that address is free…"): this
form must not be a way to ask which addresses have accounts, password
or not. The one place `taken` is said is the confirmation, to whoever
holds the link, when the address has been claimed since.

## Response `200`

Successful Response

- StatusOut: One word: the email routes say `sent` whatever the address's state.
  - `status` 'ok' | 'sent' | 'expired' | 'invalid' | 'taken', required

---

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