---
title: "Request a sign-in or registration code"
method: POST
path: "/v1/auth/email-code/request"
tags: ["Accounts"]
---

# Request a sign-in or registration code

`POST /v1/auth/email-code/request`

## Request

- Base URL: `https://api.uxduck.com`
- URL: `https://api.uxduck.com/v1/auth/email-code/request`
- Auth: none declared

With `continue`, an existing account is emailed a sign-in code and any other address a code that creates its account once verified; the email says which. `login` never creates an account and `signup` always registers. Responses do not disclose account existence, except that a staging allowlist refuses unlisted new addresses.

## Request body

- object
  - `email` string, email, required
  - `intent` 'continue' | 'login' | 'signup', required

## Response `200`

Request accepted

- object
  - `challengeId` string, required

## Other responses

- `400`: Invalid request
- `403`: Verification or registration is not allowed
- `429`: Too many requests
- `503`: Email unavailable

---

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