Skip to main content
POST
/
customer-groups
Create Customer Group
curl --request POST \
  --url https://api.mijnklantportaal.nl/v1/customer-groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Hosting customers",
  "customers": [
    "cst_abc12345"
  ]
}'
{
  "id": "cug_abc12345def678",
  "name": "Webhosting customers",
  "createdAt": "2025-07-27T14:42:00+02:00"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

Name of the Customer Group

Example:

"Hosting customers"

​
customers
string[]

An array of Customer IDs which needs to be added to the Group. Please note that unknown or wrong Customer IDs are ignored, no error is returned.

Response

Returning the created Customer Group

Customer Group

​
id
string

ID of the customer group, always starting with cug_.

Example:

"cug_abc12345def678"

​
name
string

Name of the customer group

Example:

"Webhosting customers"

​
createdAt
string

Date and time when the customer group was created, written in ATOM format.

Example:

"2025-07-27T14:42:00+02:00"