---
title: "Signup"
method: POST
path: "/v1/auth/signup"
tags: ["auth"]
---

# Signup

`POST /v1/auth/signup`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/auth/signup`
- Auth: none declared

## Request body

- SignupIn
  - `email` string, required
  - `password` string, required
  - `name` string, nullable
  - `code` string, nullable

## Response `201`

Successful Response

- SignupOut: Signup adds an OPTIONAL soft `voucher` object on top of TokenOut. It is null when no `code` was supplied; existing token fields are unchanged.
  - `access_token` string, required
  - `token_type` string
  - `expires_at` string, date-time, required
  - `refresh_token` string, nullable
  - `voucher` VoucherApplyResult
    - `applied` boolean, required
    - `error` string, nullable
    - `org_uuid` string, nullable

## Other responses

- `422`: Validation Error

---

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