{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/square/main/json-schema/square-create-customer-group-request-schema.json", "title": "CreateCustomerGroupRequest", "description": "Defines the body parameters that can be included in a request to the\n[CreateCustomerGroup](api-endpoint:CustomerGroups-CreateCustomerGroup) endpoint.", "x-generated": "2026-10-12", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/square-customer-groups-api-openapi.yml#/components/schemas/CreateCustomerGroupRequest", "type": "object", "x-release-status": "PUBLIC", "required": [ "group" ], "properties": { "idempotency_key": { "type": "string", "description": "The idempotency key for the request. For more information, see [Idempotency](https://developer.squareup.com/docs/build-basics/common-api-patterns/idempotency)." }, "group": { "$ref": "#/$defs/CustomerGroup", "description": "The customer group to create." } }, "$defs": { "CustomerGroup": { "type": "object", "description": "Represents a group of customer profiles. \n\nCustomer groups can be created, be modified, and have their membership defined using \nthe Customers API or within the Customer Directory in the Square Seller Dashboard or Point of Sale.", "x-release-status": "PUBLIC", "required": [ "name" ], "properties": { "id": { "type": "string", "description": "A unique Square-generated ID for the customer group.", "maxLength": 255, "readOnly": true }, "name": { "type": "string", "description": "The name of the customer group." }, "created_at": { "type": "string", "description": "The timestamp when the customer group was created, in RFC 3339 format.", "readOnly": true }, "updated_at": { "type": "string", "description": "The timestamp when the customer group was last updated, in RFC 3339 format.", "readOnly": true } } } } }