---
title: "Register a new user given a name and email address."
method: POST
path: "/auth/creds/create"
tags: ["auth"]
---

# Register a new user given a name and email address.

`POST /auth/creds/create`

If no password is provided then user is considered a guest.

## Request body

- UserCreateRequest — authentication
  - `campaign` string
  - `content` string
  - `country` string
  - `email` string
  - `enable_sms` boolean
  - `first_name` string
  - `intent` string
  - `last_name` string
  - `locale` string
  - `medium` string
  - `password` string
  - `password_validation_user_inputs` string[]
  - `phone` string
  - `recaptcha_response` string
  - `referral_code` string
  - `signup_source` string
  - `with_refresh_token` boolean — Used mainly for mobile clients to provide some backward compatibility for them to work with access tokens only. Will be removed when mobile adoption rate hits certain percentage

## Response `200`

HTTP status code 200 and user model

- UserAuthResponse
  - `account_id` string
  - `email` string
  - `first_name` string
  - `last_name` string
  - `phone` string
  - `preferred_2fa_method` string
  - `refresh_token` string
  - `roles` string[]
  - `session_id_2fa` string
  - `show_2fa_screen` boolean
  - `show_verify_email_screen` boolean
  - `token` string
  - `user_id` integer
  - `verifications` VerificationStatus
    - `email` boolean
    - `phone` boolean

## Other responses

- `400` — Invalid input or state means you're bad
- `default` — An unknown, unexpected error.

---

[API](https://skmtc.net/outdoorsy/apis/outdoorsy-api-documentation.md) · [All operations](https://skmtc.net/outdoorsy/apis/outdoorsy-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outdoorsy/outdoorsy-api-documentation/versions/f0cf8f605ea0/schema)