---
title: "Register a new local user"
method: POST
path: "/signup"
tags: ["Auth"]
---

# Register a new local user

`POST /signup`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/signup`
- Auth: none declared

Registers a user.

## Headers

- `API-Version` '1'

## Request body

- UserSignUpLocal: Signup model for local users.
  - `username` string, email, required
  - `password` string, required
  - `firstname` string, nullable
  - `lastname` string, nullable
  - `displayname` string, nullable
  - `phone` string, nullable
  - `marketing_email_opt_in` boolean
  - `marketing_email_opt_in_source` 'signup' | 'booking_account_create'
  - `return_url` string, nullable
  - `country` 'AU' | 'NZ'
  - `turnstile_token` string, required

## Response `200`

Successful Response

- User
  - `username` string, email, required
  - `firstname` string, nullable
  - `lastname` string, nullable
  - `displayname` string, nullable
  - `phone` string, nullable
  - `register_date` string, date-time, nullable, required
  - `is_verified` boolean, nullable
  - `roles` unknown[], nullable
    - unknown
  - `profile_pic` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/totalparks/apis/total-parks-public-api.md) · [All operations](https://skmtc.dev/totalparks/apis/total-parks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/totalparks/apis/total-parks-public-api/revisions/dcb4c822e2c6?raw)