---
title: "Create product family"
method: POST
path: "/api/v1/product_families"
tags: ["Product Families"]
---

# Create product family

`POST /api/v1/product_families`

## Request body

- ProductFamilyCreateRequest
  - `name` string, required

## Response `201`

Customer successfully created

- ProductFamily
  - `id` string, MeteroidId, required
  - `name` string, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `429` — Too many requests
- `500` — Internal error

## Changes

- **2026-03-27** (v1) `de35c02bb0d2` — 1 info
  - added the non-success response with the status `429`
- **2026-01-21** (v1) `9fba45d198be` — 2 info
  - api tag `Product Families` added
  - api tag `Product Family` removed
- **2026-01-20** (v1) `665f680338b5` — 2 info
  - api tag `Product Family` added
  - api tag `product_family` removed
- **2025-07-13** (v1) `95e4503a32c3` — 2 info
  - the endpoint scheme security `bearer_auth` was added to the API
  - the endpoint scheme security `api-key` was removed from the API
- **2025-07-09** (v1) `dece17f86f99` — 5 info
  - the endpoint scheme security `api-key` was added to the API
  - the endpoint scheme security `bearer_auth` was removed from the API
  - api tag `product_family` added
  - api tag `Product Families` removed
  - …1 more

[Change history](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/product_families/post.md)

---

[API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) · [All operations](https://skmtc.dev/meteroid-oss/apis/meteroid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/meteroid-oss/meteroid/revisions/03f9d8ae5c5e/schema)