---
title: "POST /api/auth/code/request"
method: POST
path: "/api/auth/code/request"
tags: ["Public"]
---

# POST /api/auth/code/request

`POST /api/auth/code/request`

## Request

- Base URL: `https://idkrx.com`
- URL: `https://idkrx.com/api/auth/code/request`
- Auth: none required

Email a sign-in code. Works for a new address too; signing in then creates the account.

## Request body

- object
  - `email` string, required

## Response `200`

Code sent

- AuthCodeRequestResult
  - `email` string, required
  - `exists` boolean, required
  - `deactivated` boolean, required
  - `providers` string[], required
  - `nextStep` 'code' | 'code-or-provider', required
  - `profile` AuthProfileName, required
    - `firstName` string, nullable, required
    - `lastName` string, nullable, required
  - `profileComplete` boolean, required
  - `resendAfterSeconds` integer, required
  - `codeLength` integer, required

## Other responses

- `400`: Invalid email or code
- `429`: Rate limited; retryAfterSeconds says when to try again
- `502`: The email could not be sent

---

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