---
title: "Save a new procedure"
method: POST
path: "/rest/hcpcs/code"
tags: ["hcpcs"]
---

# Save a new procedure

`POST /rest/hcpcs/code`

## Request

- Base URL: `https://api.seer.cancer.gov`
- URL: `https://api.seer.cancer.gov/rest/hcpcs/code`
- Auth: API key in header `X-SEERAPI-Key`
- TypeScript: <https://skmtc.dev/cancer/apis/seer-api/docs/rest/hcpcs/code/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- HcpcsProcedure
  - `hcpcs_code` string
  - `generic_name` string
  - `description` string
  - `brand_names` string[]
  - `strength` string
  - `fda_approval_year` string
  - `fda_discontinuation_year` string
  - `cms_approval_date` string
  - `cms_discontinuation_date` string
  - `categories` string[]
  - `major_drug_class` string
  - `minor_drug_class` string
  - `oral` boolean
  - `date_added` string, date-time
  - `date_modified` string, date-time
  - `score` number, double

## Response `200`

Success

- HcpcsProcedure
  - `hcpcs_code` string
  - `generic_name` string
  - `description` string
  - `brand_names` string[]
  - `strength` string
  - `fda_approval_year` string
  - `fda_discontinuation_year` string
  - `cms_approval_date` string
  - `cms_discontinuation_date` string
  - `categories` string[]
  - `major_drug_class` string
  - `minor_drug_class` string
  - `oral` boolean
  - `date_added` string, date-time
  - `date_modified` string, date-time
  - `score` number, double

## Other responses

- `201`: Created
- `409`: HCPCS procedure already exists

---

[API](https://skmtc.dev/cancer/apis/seer-api.md) - [All operations](https://skmtc.dev/cancer/apis/seer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cancer/apis/seer-api/revisions/2ab11538b3c7?raw)
