Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In
  • Home

  • Dev Essentials

  • Payments

  • Commerce

  • Customers

    • Customers

    • Customer Custom Attributes

    • Customer Groups

    • Customer Segments

    • Loyalty

    • Gift Cards

    • Gift Card Activities

  • Staff

  • Merchants

  • Objects & Enums

  • Webhook Events

  • Deprecated

  • SDKs

<- Square API

Square API

All versions ->

Customer Groups

Create and manage customer groups to streamline and automate workflows and help personalize customer interactions.

The Customer Groups API lets you create and manage customer groups to provide targeted promotions or take other customized actions based on group membership. For example, you can create Weekly, Monthly, and Quarterly customer groups and add customers to them based on their preferences to receive marketing promotions on a weekly, monthly, and quarterly basis. You can then use the information to manage your marketing email schedule.

You can use the Customer Groups API to retrieve and manage customer groups. You can use the Customers API to add customers to and remove customers from groups and search for customers based on group membership.

For more information, see the following guide:

  • Customer Groups
  • Endpoints

  • Webhooks

All versions ->

List customer groups

GET/v2/customers/groups

Retrieves the list of customer groups of a business.

Create customer group

POST/v2/customers/groups

Creates a new customer group for a business.

Delete customer group

DELETE/v2/customers/groups/{group_id}

Deletes a customer group as identified by the group_id value.

Retrieve customer group

GET/v2/customers/groups/{group_id}

Retrieves a specific customer group as identified by the group_id value.

Update customer group

PUT/v2/customers/groups/{group_id}

Updates a customer group as identified by the group_id value.