---
title: "Microsoft without a verified e-mail: mail a one-time code to prove the address (Bearer = the Microsoft ID token)"
method: POST
path: "/api/auth/link/start"
tags: ["auth"]
---

# Microsoft without a verified e-mail: mail a one-time code to prove the address (Bearer = the Microsoft ID token)

`POST /api/auth/link/start`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/auth/link/start`
- Auth: none declared

## Request body

- AuthLinkStartBody
  - `email` string
  - `lang` 'he' | 'en' | 'pt'

## Response `200`

A code was (or would have been) mailed.

- AuthLinkStartResponse
  - `method` 'email', required
  - `email` string, required

## Other responses

- `400`: Not a Microsoft sign-in, or no address.
- `409`: The account already has a verified e-mail.

---

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