---
title: "Create account and get API key"
method: POST
path: "/v1/auth/register"
tags: ["Authentication"]
---

# Create account and get API key

`POST /v1/auth/register`

## Request

- Base URL: `https://api.pixelvault.dev`
- URL: `https://api.pixelvault.dev/v1/auth/register`
- Auth: none declared

Creates an account with a default project and returns a live API key instantly. No browser or signup form needed. The password is optional: omit it for a passwordless (agent) account — the owner can set a password later via the reset flow to enable dashboard login.

## Request body

- object
  - `email` string, email, required
  - `password` string: Optional. Omit for a passwordless account; provide (min 8 chars) to enable password login immediately.

## Response `201`

Account created

- object
  - `data` object
    - `account_id` string
    - `email` string
    - `email_verified` boolean
    - `password_set` boolean: Whether the account has an owner-chosen password. False for passwordless accounts until a password is set via the reset flow.
    - `plan` string
    - `default_project` object
      - `id` string
      - `name` string
      - `api_keys` object
        - `live` string

## Other responses

- `400`: Validation error
- `409`: Email already registered

---

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