---
title: "Create a pending FlashData account"
method: POST
path: "/auth/register"
tags: ["Auth"]
---

# Create a pending FlashData account

`POST /auth/register`

## Request

- Base URL: `https://api.flashdata.dev/v2`
- URL: `https://api.flashdata.dev/v2/auth/register`
- Auth: none required

The submitted Terms and Privacy versions must match the current published legal bundle.

## Request body

- RegisterRequest
  - `name` string: Optional display name. When omitted, defaults to the normalized email local part, truncated to 100 characters. Can be changed in the profile later.
  - `email` string, email, required
  - `password` string, required
  - `acceptedTerms` true, required
  - `termsVersion` string, required: Exact version rendered by the signup page; stale versions are rejected.
  - `privacyVersion` string, required: Exact version rendered by the signup page; stale versions are rejected.

## Response `201`

Account created; email verification required

- RegisterResponse: Generic receipt returned for both a new account and a recoverable pending account. It intentionally omits identity data to limit account enumeration.
  - `emailVerificationRequired` true, required

## Other responses

- `409`: Resource state or idempotency conflict
- `422`: Request validation failed
- `429`: Rate, concurrency, batch, or pending-job limit exceeded
- `500`: An unexpected internal error occurred
- `503`: A required dependency or catalog is temporarily unavailable

---

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