---
title: "Principal Signup Start"
method: POST
path: "/v1/auth/principal/signup/start"
tags: ["auth"]
---

# Principal Signup Start

`POST /v1/auth/principal/signup/start`

## Request

- Base URL: `https://api.mundane.market` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mundane.market/v1/auth/principal/signup/start`
- Auth: none declared

Send a signup link. Creates nothing but the token.

Answers 202 whether or not the address already has an account, for the
same reason the login route does: a signup form that says "already
registered" is an account-existence oracle for any address someone cares
to type.

## Request body

- PrincipalSignupStart
  - `email` string, email, required
  - `source` string, nullable
  - `return_to` string, nullable

## Response `202`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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