Customer Groups
A Customer can be a member of a Customer Group (for example, reseller, gold member). Special prices can be assigned to specific products based on a Customer Group.
A maximum number of 1 000 Customer Groups can be created per Project. Learn more about this limit.
Learn more about managing Customer Groups in our self-paced Customer Management module.
Representations
CustomerGroup
id String | Unique identifier of the CustomerGroup. |
version Int | Current version of the CustomerGroup. |
key String | User-defined unique identifier for the CustomerGroup. MinLength:2 MaxLength: 256 Pattern: ^[A-Za-z0-9_-]+$ |
name String | Unique name of the CustomerGroup. |
custom | Custom Fields for the CustomerGroup. |
createdAt | Date and time (UTC) the CustomerGroup was initially created. |
createdBy BETA | Present on resources created after 1 February 2019 except for events not tracked. |
lastModifiedAt | Date and time (UTC) the CustomerGroup was last updated. |
lastModifiedBy BETA | Present on resources updated after 1 February 2019 except for events not tracked. |
CustomerGroupDraft
key String | User-defined unique identifier for the CustomerGroup. MinLength:2 MaxLength: 256 Pattern: ^[A-Za-z0-9_-]+$ |
groupName String | Unique value which must be different from any value used for |
custom | Custom Fields for the CustomerGroup. |
CustomerGroupPagedQueryResponse
PagedQueryResult with results
containing an array of CustomerGroup.
limit Int | Number of results requested. |
offset Int | Number of elements skipped. |
count Int | Actual number of results returned. |
total Int | Total number of results matching the query.
This number is an estimation that is not strongly consistent.
This field is returned by default.
For improved performance, calculating this field can be deactivated by using the query parameter |
results Array of CustomerGroup | CustomerGroups matching the query. |
CustomerGroupReference
Reference to a CustomerGroup.
id String | Unique identifier of the referenced CustomerGroup. |
typeId String | "customer-group" References a CustomerGroup. |
obj | Contains the representation of the expanded CustomerGroup. Only present in responses to requests with Reference Expansion for CustomerGroups. |
CustomerGroupResourceIdentifier
id String | Unique identifier of the referenced CustomerGroup. Either |
key String | User-defined unique identifier of the referenced CustomerGroup. Either |
typeId String | "customer-group" References a CustomerGroup. |
Get CustomerGroup
Get CustomerGroup by ID
view_customers:{projectKey},
view_customer_groups:{projectKey}
region String | Region in which the Project is hosted. |
projectKey String |
|
id String |
|
expand | The parameter can be passed multiple times. |
curl --get https://api.{region}.commercetools.com/{projectKey}/customer-groups/{id} -i \--header 'Authorization: Bearer ${BEARER_TOKEN}'
{"id" : "aef9cf41-94ad-4794-8122-62d308900430","version" : 2,"name" : "Webshop user","createdAt" : "2017-01-10T06:51:25.896Z","lastModifiedAt" : "2017-01-10T06:51:25.946Z"}
Get CustomerGroup by Key
view_customers:{projectKey},
view_customer_groups:{projectKey}
region String | Region in which the Project is hosted. |
projectKey String |
|
key String |
|
expand | The parameter can be passed multiple times. |
curl --get https://api.{region}.commercetools.com/{projectKey}/customer-groups/key={key} -i \--header 'Authorization: Bearer ${BEARER_TOKEN}'
{"id" : "aef9cf41-94ad-4794-8122-62d308900430","version" : 2,"name" : "Webshop user","createdAt" : "2017-01-10T06:51:25.896Z","lastModifiedAt" : "2017-01-10T06:51:25.946Z"}
Query CustomerGroups
view_customers:{projectKey},
view_customer_groups:{projectKey}
region String | Region in which the Project is hosted. |
projectKey String |
|
where | Queryable field: The parameter can be passed multiple times. |
/^var[.][a-zA-Z0-9]+$/ Any string parameter matching this regular expression | Predicate parameter values. The parameter can be passed multiple times. |
sort | The parameter can be passed multiple times. |
expand | The parameter can be passed multiple times. |
limit Int | Number of results requested. |
offset Int | Number of elements skipped. |
withTotal Boolean | Controls the calculation of the total number of query results. Set to |
curl --get https://api.{region}.commercetools.com/{projectKey}/customer-groups -i \--header 'Authorization: Bearer ${BEARER_TOKEN}'
{"limit" : 20,"offset" : 0,"count" : 1,"total" : 1,"results" : [ {"id" : "aef9cf41-94ad-4794-8122-62d308900430","version" : 2,"name" : "Webshop user","createdAt" : "2017-01-10T06:51:25.896Z","lastModifiedAt" : "2017-01-10T06:51:25.946Z"} ]}
Create CustomerGroup
manage_customers:{projectKey},
manage_customer_groups:{projectKey}
region String | Region in which the Project is hosted. |
projectKey String |
|
expand | The parameter can be passed multiple times. |
application/json
application/json
curl https://api.{region}.commercetools.com/{projectKey}/customer-groups -i \--header 'Authorization: Bearer ${BEARER_TOKEN}' \--header 'Content-Type: application/json' \--data-binary @- << DATA{"groupName" : "Webshop user"}DATA
{"id" : "aef9cf41-94ad-4794-8122-62d308900430","version" : 2,"name" : "Webshop user","createdAt" : "2017-01-10T06:51:25.896Z","lastModifiedAt" : "2017-01-10T06:51:25.946Z"}
Update CustomerGroup
Update CustomerGroup by ID
manage_customers:{projectKey},
manage_customer_groups:{projectKey}
region String | Region in which the Project is hosted. |
projectKey String |
|
id String |
|
expand | The parameter can be passed multiple times. |
application/json
version Int | Expected version of the CustomerGroup on which the changes should be applied. If the expected version does not match the actual version, a ConcurrentModification error is returned. |
actions Array of CustomerGroupUpdateAction | Update actions to be performed on the CustomerGroup. |
application/json
curl https://api.{region}.commercetools.com/{projectKey}/customer-groups/{id} -i \--header 'Authorization: Bearer ${BEARER_TOKEN}' \--header 'Content-Type: application/json' \--data-binary @- << DATA{"version" : 1,"actions" : [ {"action" : "changeName","name" : "New Name"} ]}DATA
{"id" : "aef9cf41-94ad-4794-8122-62d308900430","version" : 2,"name" : "Webshop user","createdAt" : "2017-01-10T06:51:25.896Z","lastModifiedAt" : "2017-01-10T06:51:25.946Z"}
Update CustomerGroup by Key
manage_customers:{projectKey},
manage_customer_groups:{projectKey}
region String | Region in which the Project is hosted. |
projectKey String |
|
key String |
|
expand | The parameter can be passed multiple times. |
application/json
version Int | Expected version of the CustomerGroup on which the changes should be applied. If the expected version does not match the actual version, a ConcurrentModification error is returned. |
actions Array of CustomerGroupUpdateAction | Update actions to be performed on the CustomerGroup. |
application/json
curl https://api.{region}.commercetools.com/{projectKey}/customer-groups/key={key} -i \--header 'Authorization: Bearer ${BEARER_TOKEN}' \--header 'Content-Type: application/json' \--data-binary @- << DATA{"version" : 1,"actions" : [ {"action" : "changeName","name" : "New Name"} ]}DATA
{"id" : "aef9cf41-94ad-4794-8122-62d308900430","version" : 2,"name" : "Webshop user","createdAt" : "2017-01-10T06:51:25.896Z","lastModifiedAt" : "2017-01-10T06:51:25.946Z"}
Update actions
Change Name
action String | "changeName" |
name String | New name of the CustomerGroup. |
{"action" : "changeName","name" : "New Name"}
Set Key
action String | "setKey" |
key String | If 2 MaxLength: 256 Pattern: ^[A-Za-z0-9_-]+$ |
{"action" : "setKey","key" : "newKey"}
Set Custom Type
This action sets or removes the custom type for an existing CustomerGroup. If present, this action overwrites any existing custom type and fields.
action String | "setCustomType" |
type | Defines the Type that extends the CustomerGroup with Custom Fields. If absent, any existing Type and Custom Fields are removed from the CustomerGroup. |
fields | Sets the Custom Fields fields for the CustomerGroup. |
{"action" : "setCustomType","type" : {"id" : "{{type-id}}","typeId" : "type"},"fields" : {"exampleStringTypeField" : "TextString"}}
Set CustomField
action String | "setCustomField" |
name String | Name of the Custom Field. |
value | If |
{"action" : "setCustomField","name" : "ExampleStringTypeField","value" : "TextString"}
Delete CustomerGroup
Delete CustomerGroup by ID
manage_customers:{projectKey},
manage_customer_groups:{projectKey}
region String | Region in which the Project is hosted. |
projectKey String |
|
id String |
|
version Int | Last seen version of the resource. |
expand | The parameter can be passed multiple times. |
curl -X DELETE https://api.{region}.commercetools.com/{projectKey}/customer-groups/{id}?version={version} -i \--header 'Authorization: Bearer ${BEARER_TOKEN}'
{"id" : "aef9cf41-94ad-4794-8122-62d308900430","version" : 2,"name" : "Webshop user","createdAt" : "2017-01-10T06:51:25.896Z","lastModifiedAt" : "2017-01-10T06:51:25.946Z"}
Delete CustomerGroup by Key
manage_customers:{projectKey},
manage_customer_groups:{projectKey}
region String | Region in which the Project is hosted. |
projectKey String |
|
key String |
|
version Int | Last seen version of the resource. |
expand | The parameter can be passed multiple times. |
curl -X DELETE https://api.{region}.commercetools.com/{projectKey}/customer-groups/key={key}?version={version} -i \--header 'Authorization: Bearer ${BEARER_TOKEN}'
{"id" : "aef9cf41-94ad-4794-8122-62d308900430","version" : 2,"name" : "Webshop user","createdAt" : "2017-01-10T06:51:25.896Z","lastModifiedAt" : "2017-01-10T06:51:25.946Z"}