Back to Square in Google Sheets
SheetXAI logo
Square logo
Square · Google Sheets Guide

Add a Batch of Square Customers to a Customer Group From a Sheet

2026-05-13
4 min read
See the Excel version →

The Scenario

You are a retail operations manager. Your analytics team just identified 120 high-spend customers based on purchase history. Their Square customer IDs are in a Google Sheet, column A, 120 rows.

You want all 120 added to your Square "VIP" customer group before the holiday campaign goes out next Thursday. The VIP group controls which promotional emails they receive and which in-store discount they qualify for at the point of sale.

The manual version:

  • Log into Square's Customer Directory
  • Open the VIP group
  • Click "Add customers"
  • Search for the first customer by ID
  • Add them
  • Repeat for the next 119
  • Forty-five minutes of clicking you will not get back.

The fast version is one prompt.

The Easy Way: One Prompt in SheetXAI

SheetXAI is an AI agent inside your Google Sheet that reads the customer IDs and adds each one to the specified Square customer group, writing a result back per row.

Open the SheetXAI sidebar and type:

Add every customer ID in column A of this sheet to the Square customer group whose ID is in cell B1. Write "Added" into column B for each success, or the error message if it failed.

Put your VIP group's Square group ID into cell B1. SheetXAI calls Square's group membership endpoint for each customer ID in column A and writes "Added" or an error into the corresponding cell in column B.

What You Get

A sheet with 120 rows resolved:

  • Column B: "Added" for every customer successfully added to the VIP group
  • Column B: error message for any ID that failed — customer not found, group not found, already a member, etc.
  • Complete audit trail — you know who made it into the group and who did not before the campaign fires

Already-a-member errors are not a problem. They mean the customer was already in the VIP group. You can write a separate note for those rows or just treat them as confirmed.

What If the Data Is Not Quite Ready

High-spend customer lists come with real-world complications. SheetXAI handles them in the same prompt.

When the list has duplicate customer IDs

Your analytics export has a handful of duplicates because the same customer appeared in multiple segments.

Deduplicate column A by customer ID before running the group add. Then add each unique customer ID to the Square group in cell B1 and write "Added" or the error into column B.

When you want to add to multiple groups at once

Some customers should go into VIP, others into a "Frequent Buyer" group, based on a flag in column C.

For each row, check column C. If column C says "VIP," add the customer ID in column A to the Square group whose ID is in cell D1. If column C says "Frequent," add them to the group in cell D2. Write "Added to VIP," "Added to Frequent," or the error message into column B.

When you want to verify each customer profile exists before adding

Your customer ID list came from an older export and some customers may have been deleted since then.

For each customer ID in column A, first verify the Square customer profile exists. If it exists, add them to the group in cell B1 and write "Added" into column B. If the profile does not exist, write "Profile not found" into column B. Skip the group add for missing profiles.

When you need to pull the high-spend customers, add them to the group, and confirm in one shot

You have the order data in the sheet and want SheetXAI to identify the top spenders, add them to the VIP group, and write the result — all in one prompt.

In the Orders tab, calculate total spend per customer ID across all rows. Identify the top 120 customers by total spend. For each, add their customer ID to the Square group in cell B1 of the Groups tab. Write "Added" or the error into column C of the Groups tab for each customer processed.

The pattern: the identification, the group add, and the audit log all happen in the same prompt. You do not need to do the analysis separately and then run a second pass.

Try It

Get the 7-day free trial of SheetXAI and get your high-spend customers into the right Square group before the next campaign. The Square integration is included in every SheetXAI plan. For related workflows, see how to look up Square customer IDs from a list of emails or the Square in Google Sheets overview.

Stop memorizing formulas.
Tell your spreadsheet what to do.

Join 4,000+ professionals saving hours every week with SheetXAI.

Learn more