---
title: "Create Lab Test For Team"
method: POST
path: "/v3/lab_tests"
tags: ["lab_tests"]
---

# Create Lab Test For Team

`POST /v3/lab_tests`

## Request body

- CreateLabTestRequest
  - `marker_ids` integer[], nullable
  - `provider_ids` string[], nullable
  - `name` string, required
  - `method` 'testkit' | 'walk_in_test' | 'at_home_phlebotomy' | 'on_site_collection', required — The method used to perform a lab test. ℹ️ This enum is non-exhaustive.
  - `description` string, required
  - `fasting` boolean, nullable
  - `lab_account_id` string, uuid, nullable
  - `lab_slug` 'ayumetrix' | 'spiriplex' | 'ussl' | 'quest' | 'sonora_quest' | 'labcorp' | 'bioreference' | 'us_biotek' | 'manual' | 'sanocardio' | 'ihd' | 'nexus' | 'my_uti' | 'crl' | 'mtl' — ℹ️ This enum is non-exhaustive.

## Response `200`

Successful Response

- ClientFacingLabTest
  - `id` string, uuid, required
  - `slug` string, required
  - `name` string, required
  - `sample_type` 'dried_blood_spot' | 'arm_collector' | 'serum' | 'saliva' | 'urine' | 'stool', required — The type of sample used to perform a lab test. ℹ️ This enum is non-exhaustive.
  - `method` 'testkit' | 'walk_in_test' | 'at_home_phlebotomy' | 'on_site_collection', required — The method used to perform a lab test. ℹ️ This enum is non-exhaustive.
  - `price` number, required
  - `is_active` boolean, required — Deprecated. Use status instead.
  - `status` 'active' | 'pending_approval' | 'inactive', required — ℹ️ This enum is non-exhaustive.
  - `fasting` boolean — Defines whether a lab test requires fasting.
  - `lab` ClientFacingLab, required
    - `id` integer, required
    - `slug` string, required
    - `name` string, required
    - `first_line_address` string, required
    - `city` string, required
    - `zipcode` string, required
    - `collection_methods` LabTestCollectionMethod[], required
    - `sample_types` LabTestSampleType[], required
    - `logo_url` string, nullable
  - `markers` ClientFacingMarker[], nullable, required
    - `id` integer, required
    - `name` string, required
    - `slug` string, required
    - `description` string, nullable
    - `lab_id` integer, nullable
    - `provider_id` string, nullable
    - `type` 'biomarker' | 'panel' — ℹ️ This enum is non-exhaustive.
    - `unit` string, nullable
    - `price` string, nullable
    - `aoe` AoE
      - `questions` Question[], required
        - `id` integer, required
        - `required` boolean, required
        - `code` string, required
        - `value` string, required
        - `type` 'choice' | 'text' | 'numeric' | 'multi_choice', required — ℹ️ This enum is non-exhaustive.
        - `sequence` integer, required
        - `answers` Answer[], required
          - `id` integer, required
          - `code` string, required
          - `value` string, required
        - `constraint` string, nullable
        - `default` string, nullable
    - `a_la_carte_enabled` boolean
    - `common_tat_days` integer, nullable
    - `worst_case_tat_days` integer, nullable
    - `is_orderable` boolean, nullable
  - `is_delegated` boolean — Deprecated and always false. Delegation is now at the lab account level. Used to denote whether a lab test requires using non-Vital physician networks.
  - `auto_generated` boolean — Whether the lab test was auto-generated by Vital
  - `has_collection_instructions` boolean, nullable — Whether or not the lab test has collection instructions.
  - `common_tat_days` integer, nullable — The common turnaround time in days for the lab test. This is the expected time for the lab to process the test and return results.
  - `worst_case_tat_days` integer, nullable — The worst-case turnaround time in days for the lab test. This is the maximum time the lab may take to process the test and return results.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/tryvital/apis/junction-api.md) · [All operations](https://skmtc.net/tryvital/apis/junction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryvital/junction-api/revisions/1a22b97afb3a/schema)