---
title: "Request a sign-up code"
method: POST
path: "/api/v1/auth/signup"
tags: ["authentication"]
---

# Request a sign-up code

`POST /api/v1/auth/signup`

Sends a one-time code to the given email and returns a `verificationId` to complete sign-up. No authentication required.

## Request body

- object
  - `email` string, email, required — The address to send the code to. Addresses that reach the same mailbox are treated as one account: a `+tag` is dropped from the local part, dots are ignored in a `gmail.com` local part, and `googlemail.com` is read as `gmail.com`. So `dev.user+dial@gmail.com` signs in to the account owned by `devuser@gmail.com` rather than creating a second one, and the account is created under that canonical address.

## Response `200`

Code sent.

- AuthenticationSignupResponse200
  - `verificationId` string

## Other responses

- `400` — The request body failed validation.

---

[API](https://skmtc.dev/getdial/apis/rest-api.md) · [All operations](https://skmtc.dev/getdial/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getdial/rest-api/revisions/e497bfa5f724/schema)