---
title: "CreateCustomerGroup"
method: POST
path: "/v2/customers/groups"
tags: ["CustomerGroups"]
---

# CreateCustomerGroup

`POST /v2/customers/groups`

Creates a new customer group for a business.

The request must include the `name` value of the group.

## Request body

- CreateCustomerGroupRequest — Defines the body parameters that can be included in a request to the [CreateCustomerGroup](https://developer.squareup.com/reference/square_2021-08-18/customer-groups-api/create-customer-group) endpoint.
  - `group` CustomerGroup, required — Represents a group of customer profiles. Customer groups can be created, be modified, and have their membership defined using the Customers API or within the Customer Directory in the Square Seller Dashboard or Point of Sale.
    - `created_at` string — The timestamp when the customer group was created, in RFC 3339 format.
    - `id` string — A unique Square-generated ID for the customer group.
    - `name` string, required — The name of the customer group.
    - `updated_at` string — The timestamp when the customer group was last updated, in RFC 3339 format.
  - `idempotency_key` string — The idempotency key for the request. For more information, see [Idempotency](https://developer.squareup.com/docs/basics/api101/idempotency).

## Response `200`

Success

- CreateCustomerGroupResponse — Defines the fields that are included in the response body of a request to the [CreateCustomerGroup](https://developer.squareup.com/reference/square_2021-08-18/customer-groups-api/create-customer-group) endpoint. Either `errors` or `group` is present in a given response (never both).
  - `errors` Error[] — Any errors that occurred during the request.
    - `category` string, required — The high-level category for the error.
    - `code` string, required — The specific code of the error.
    - `detail` string — A human-readable description of the error for debugging purposes.
    - `field` string — The name of the field provided in the original request (if any) that the error pertains to.
  - `group` CustomerGroup — Represents a group of customer profiles. Customer groups can be created, be modified, and have their membership defined using the Customers API or within the Customer Directory in the Square Seller Dashboard or Point of Sale.
    - `created_at` string — The timestamp when the customer group was created, in RFC 3339 format.
    - `id` string — A unique Square-generated ID for the customer group.
    - `name` string, required — The name of the customer group.
    - `updated_at` string — The timestamp when the customer group was last updated, in RFC 3339 format.

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/revisions/8d95e3639487/schema)