---
title: "Create a new customer family"
method: POST
path: "/v1/customerfamilies"
tags: ["CustomerFamilies"]
---

# Create a new customer family

`POST /v1/customerfamilies`

## Request

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

## Request body

- CustomerFamily: Customer family
  - `id` integer: ID
  - `internalId` string, nullable: Internal ID
  - `label` string, nullable: Label
  - `number` string, nullable: Number

## Response `200`

OK

- CustomerFamily: Customer family
  - `id` integer: ID
  - `internalId` string, nullable: Internal 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/customerfamilies/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)