---
title: "Create new customer group"
method: POST
path: "/customer_groups"
tags: ["Customer Groups"]
---

# Create new customer group

`POST /customer_groups`

Create a new customer group

🔒 Requires: `customers:write` scope

## Request body

- CustomerGroup
  - `created_at` string — Creation timestamp in UTC.
  - `deleted_at` string, nullable — Deletion timestamp in UTC.
  - `group_id` string — The customer group identifier.
  - `id` string — Auto-generated object ID.
  - `name` string, required — The customer group name.
  - `retailer_id` string — The retailer identifier
  - `updated_at` string — Last update timestamp in UTC.
  - `version` integer — Auto-incrementing object version number.

## Response `201`

Created

- CustomerGroupResponse
  - `data` CustomerGroup
    - `created_at` string — Creation timestamp in UTC.
    - `deleted_at` string, nullable — Deletion timestamp in UTC.
    - `group_id` string — The customer group identifier.
    - `id` string — Auto-generated object ID.
    - `name` string, required — The customer group name.
    - `retailer_id` string — The retailer identifier
    - `updated_at` string — Last update timestamp in UTC.
    - `version` integer — Auto-incrementing object version number.

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)