Customer Segment

Represents a group of customer profiles that match one or more predefined filter criteria.

Segments (also known as Smart Groups) are defined and created within the Customer Directory in the Square Seller Dashboard or Point of Sale.

Structure

CustomerSegment

Name	Type	Tags	Description
`id`	`string \| undefined`	Optional	A unique Square-generated ID for the segment. Constraints: Maximum Length: `255`
`name`	`string`	Required	The name of the segment.
`createdAt`	`string \| undefined`	Optional	The timestamp when the segment was created, in RFC 3339 format.
`updatedAt`	`string \| undefined`	Optional	The timestamp when the segment was last updated, in RFC 3339 format.

{}