---
title: "Create purchased component"
method: POST
path: "/suppliers/public/purchased_components"
tags: ["Purchased Components"]
---

# Create purchased component

`POST /suppliers/public/purchased_components`

## Request

- Base URL: `https://api.paperlessparts.com/v1`
- URL: `https://api.paperlessparts.com/v1/suppliers/public/purchased_components`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/paperlessparts/apis/paperless-parts-api/docs/suppliers/public/purchased_components/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a purchased component

## Request body

- PostPurchasedComponent
  - `oem_part_number` string, required: Unique identifier for purchased component within a supplier account
  - `internal_part_number` string, nullable
  - `description` string, nullable
  - `piece_price` number, required: Cost per piece to 4 decimal places
  - `properties` PurchasedComponentCustomProperty[], required
    - `key` string: Name of corresponding purchased component column in table display
    - `value` union: Value of property, None or of type corresponding to value_type
      - string
      - number
      - boolean

## Response `200`

Successful Response

- PurchasedComponent[]
  - `oem_part_number` string: Unique identifier for purchased component within a supplier account
  - `internal_part_number` string, nullable
  - `description` string, nullable
  - `piece_price` number: Cost per piece to 4 decimal places
  - `id` integer
  - `properties` PurchasedComponentCustomProperty[]
    - `key` string: Name of corresponding purchased component column in table display
    - `value` union: Value of property, None or of type corresponding to value_type
      - string
      - number
      - boolean
  - `thumbnail_url` string, nullable

---

[API](https://skmtc.dev/paperlessparts/apis/paperless-parts-api.md) - [All operations](https://skmtc.dev/paperlessparts/apis/paperless-parts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paperlessparts/apis/paperless-parts-api/revisions/3eb132ead1fe?raw)
