---
title: "Signup"
method: POST
path: "/internal/api/auth/signup"
tags: ["USERS"]
---

# Signup

`POST /internal/api/auth/signup`

## Request

- Base URL: `https://api.signalshq.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.signalshq.io/internal/api/auth/signup`
- Auth: none declared

## Request body

- UserSignupRequest
  - `email` string, email, required
  - `password` string, required
  - `name` string, required
  - `recaptcha_token` string, nullable: Google reCAPTCHA token (v3 or v2)
  - `recaptcha_version` 'v2' | 'v3'

## Response `201`

Successful Response

- UserSignUpResponse: Original signup response with optional fields for backward compatibility
  - `access_token` string, nullable
  - `token_type` string, nullable
  - `access_token_expire_in_minutes` integer, nullable
  - `user_details` UserDetails, required
    - `id` string
    - `email` string, email, nullable
    - `name` string, nullable
    - `status` string, nullable
  - `message` string, nullable: Message about the signup status
  - `requires_verification` boolean, nullable: Whether email verification is required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/signalshq/apis/signals-api.md) - [All operations](https://skmtc.dev/signalshq/apis/signals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalshq/apis/signals-api/revisions/2c22af3b5576?raw)