---
title: "Create Preregistration"
method: POST
path: "/api/v4/preregistration/create"
tags: ["preregistration"]
---

# Create Preregistration

`POST /api/v4/preregistration/create`

## Request

- Base URL: `https://api.endless.health` (the document declares no server; this is the origin it was published from)
- URL: `https://api.endless.health/api/v4/preregistration/create`
- Auth: API key in header `X-API-KEY`

## Request body

- PreregistrationCreationSchema
  - `first_name` string, required
  - `last_name` string, required
  - `date_of_birth` string, date, required
  - `create_shipment` boolean, required
  - `enforce_email` boolean
  - `activation_code` string, nullable
  - `language` 'en' | 'es'
  - `sex` 'MALE' | 'FEMALE'
  - `race` string[], nullable
  - `sub_race` string[], nullable
  - `email` string, nullable
  - `phone` integer, nullable
  - `street_address` string, nullable
  - `street_address_2` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `zip_code` string, nullable
  - `test_panel_id` integer, nullable
  - `sample_type` 'SERUM_SEPARATOR' | 'SERUM_SEPARATOR_SERUM' | 'SERUM_SEPARATOR_BLOOD' | 'HEPARIN_CAPILLARY_BLOOD' | 'HEPARIN_CAPILLARY_PLASMA' | 'HEPARIN_VENOUS_BLOOD' | 'HEPARIN_VENOUS_PLASMA' | 'EDTA_CAPILLARY_BLOOD' | 'EDTA_CAPILLARY_PLASMA' | 'EDTA_VENOUS_BLOOD' | 'EDTA_VENOUS_PLASMA' | 'UNKNOWN'
  - `sample_collection_method` 'ADX_CARD' | 'EH_CASSETTE_V1' | 'REDDROP' | 'TASSO' | 'VACUTAINER'

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: Not found
- `422`: Validation Error

## Changes

- **2026-11-04** `9046a1eb2d0c`: 1 info
  - added the new `TASSO` enum value to the request property `sample_collection_method/anyOf[subschema #1: CollectionMethods]/`

[Operation history](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/changes/api/v4/preregistration/create/post.md)

---

[API](https://skmtc.dev/endless/apis/eh-core-v3-api-prod.md) - [All operations](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/llms.txt) - [OpenAPI document](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/revisions/9046a1eb2d0c?raw)
