---
title: "Create a new product family"
method: POST
path: "/v1/productfamilies"
tags: ["ProductFamilies"]
---

# Create a new product family

`POST /v1/productfamilies`

## Request

- Base URL: `https://api.altoviz.com`
- URL: `https://api.altoviz.com/v1/productfamilies`
- Auth: none required
- TypeScript: <https://skmtc.dev/altoviz/apis/altoviz-api/docs/v1/productfamilies/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- ProductFamily: Product family
  - `id` integer: ID
  - `label` string, nullable: Label
  - `number` string, nullable: Number

## Response `200`

OK

- ProductFamily: Product family
  - `id` integer: ID
  - `label` string, nullable: Label
  - `number` string, nullable: Number

## Other responses

- `400`: Bad Request

## Changes

- **2026-09-14** `4f7fa64cf9e3`: 1 breaking
  - removed the media type `application/json-patch+json` from the request body

[Operation history](https://skmtc.dev/altoviz/apis/altoviz-api/changes/v1/productfamilies/post.md)

---

[API](https://skmtc.dev/altoviz/apis/altoviz-api.md) - [All operations](https://skmtc.dev/altoviz/apis/altoviz-api/llms.txt) - [OpenAPI document](https://skmtc.dev/altoviz/apis/altoviz-api/revisions/4f7fa64cf9e3?raw)