---
title: "Create a package group"
method: POST
path: "/api/v1/package_groups"
tags: ["Packages & Services"]
---

# Create a package group

`POST /api/v1/package_groups`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/package_groups`
- Auth: none declared. Required headers: `Api-Key`

Creates a new package group within a service (event category). A package group organizes related packages (event types) — for example, a "DJ Services" service might contain "Wedding Packages" and "Corporate Packages".

The `event_category_id` of the parent service is required, along with a `name`. New package groups are appended to the end of the service's package-group list.

**Required permission:** `offerings_write`

## Headers

- `Api-Key` string, required

## Request body

- object
  - `event_category_id` integer, required: ID of the parent service (event category) this package group belongs to
  - `name` string, required: The name of the package group (e.g., "Wedding Packages")
  - `sub_header` string: Short sub-heading shown under the package-group name on booking pages (max 100 characters)
  - `show_on_booking_page` boolean: Whether this package group is shown on public booking pages
  - `show_title_on_booking_page` boolean: Whether to show the package-group title on the booking page
  - `package_sort_preference` 'name' | 'price' | 'manual': How packages within this group are ordered
  - `pricing_mode` 'show' | 'delay': Whether pricing is shown or delayed during booking

## Response `200`

package group created

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)