# Customer Groups

A Customer can be a member of multiple Customer Groups. Special prices can be assigned to specific products based on a Customer Group.

A maximum number of 10000 Customer
Groups can be created per Project. This is a soft limit that can be increased per Project after a performance impact review. See [Limit increase guidance](https://docs.commercetools.com/api/limit-increase-guidance.md#b2b-hierarchy-and-permission-limits).

## Representations

#### CustomerGroup

See API type definition [CustomerGroup](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Atype%3ACustomerGroup).

#### CustomerGroupDraft

See API type definition [CustomerGroupDraft](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Atype%3ACustomerGroupDraft).

#### CustomerGroupPagedQueryResponse

See API type definition [CustomerGroupPagedQueryResponse](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Atype%3ACustomerGroupPagedQueryResponse).

#### CustomerGroupReference

See API type definition [CustomerGroupReference](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Atype%3ACustomerGroupReference).

#### CustomerGroupKeyReference

See API type definition [CustomerGroupKeyReference](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aimport%3Atype%3ACustomerGroupKeyReference).

#### CustomerGroupResourceIdentifier

See API type definition [CustomerGroupResourceIdentifier](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Atype%3ACustomerGroupResourceIdentifier).

## Get CustomerGroup

### Get CustomerGroup by ID

See API endpoint definition [GET /\{projectKey}/customer-groups/\{id}](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%2F%7Bid%7D%3AGET).

### Get CustomerGroup by Key

See API endpoint definition [GET /\{projectKey}/customer-groups/key=\{key}](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%2Fkey%3D%7Bkey%7D%3AGET).

## Query CustomerGroups

See API endpoint definition [GET /\{projectKey}/customer-groups](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%3AGET).

## Check if CustomerGroup exists

### Check if CustomerGroup exists by ID

See API endpoint definition [HEAD /\{projectKey}/customer-groups/\{id}](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%2F%7Bid%7D%3AHEAD).

### Check if CustomerGroup exists by Key

See API endpoint definition [HEAD /\{projectKey}/customer-groups/key=\{key}](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%2Fkey%3D%7Bkey%7D%3AHEAD).

### Check if CustomerGroup exists by Query Predicate

See API endpoint definition [HEAD /\{projectKey}/customer-groups](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%3AHEAD).

## Create CustomerGroup

See API endpoint definition [POST /\{projectKey}/customer-groups](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%3APOST).

## Update CustomerGroup

### Update CustomerGroup by ID

See API endpoint definition [POST /\{projectKey}/customer-groups/\{id}](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%2F%7Bid%7D%3APOST).

### Update CustomerGroup by Key

See API endpoint definition [POST /\{projectKey}/customer-groups/key=\{key}](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%2Fkey%3D%7Bkey%7D%3APOST).

## Update actions

#### Change Name

See API type definition [CustomerGroupChangeNameAction](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Atype%3ACustomerGroupChangeNameAction).

#### Set Key

See API type definition [CustomerGroupSetKeyAction](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Atype%3ACustomerGroupSetKeyAction).

#### Set Custom Type

See API type definition [CustomerGroupSetCustomTypeAction](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Atype%3ACustomerGroupSetCustomTypeAction).

#### Set CustomField

See API type definition [CustomerGroupSetCustomFieldAction](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Atype%3ACustomerGroupSetCustomFieldAction).

## Delete CustomerGroup

### Delete CustomerGroup by ID

See API endpoint definition [DELETE /\{projectKey}/customer-groups/\{id}](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%2F%7Bid%7D%3ADELETE).

### Delete CustomerGroup by Key

See API endpoint definition [DELETE /\{projectKey}/customer-groups/key=\{key}](https://docs.commercetools.com/api/projects/customerGroups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomer-groups%2Fkey%3D%7Bkey%7D%3ADELETE).

## Related pages

- [Section overview page](https://docs.commercetools.com/api.md)
- [Previous page: Customer Search](https://docs.commercetools.com/api/projects/customer-search.md)