# \#customers-api

**URL:** https://developer.squareup.com/forums/tag/customers-api/2.md

[Latest](https://developer.squareup.com/forums/latest.md) · [Categories](https://developer.squareup.com/forums/categories.md) · [Tags](https://developer.squareup.com/forums/tags.md)

---

## [Square Customer Merge: Impact on Cards API IDs and CreatePayment](https://developer.squareup.com/forums/t/square-customer-merge-impact-on-cards-api-ids-and-createpayment/28327)

<div class="topic-metadata">

**Author:** [@nrizzo10](https://developer.squareup.com/forums/u/nrizzo10)\
**Replies:** 1\
**Last updated:** [October 26, 2026, 9:08am UTC](https://developer.squareup.com/forums/t/square-customer-merge-impact-on-cards-api-ids-and-createpayment/28327 "2026-10-26T09:08:44Z")

</div>

We store Square customer IDs and card-on-file IDs (Cards API) and charge with CreatePayment using source\_id = card ID and customer\_id = our stored customer ID. Your “Duplicate customer profiles” page says a merged custo…

---

## [Request for Official Weebly API Documentation and Third-Party Integration Access](https://developer.squareup.com/forums/t/request-for-official-weebly-api-documentation-and-third-party-integration-access/28163)

<div class="topic-metadata">

**Author:** [@Viasocket](https://developer.squareup.com/forums/u/Viasocket)\
**Replies:** 1\
**Last updated:** [October 9, 2026, 3:55pm UTC](https://developer.squareup.com/forums/t/request-for-official-weebly-api-documentation-and-third-party-integration-access/28163 "2026-10-09T15:55:20Z")

</div>

Hi Square Developer Team, I’m reaching out from viaSocket, a no-code workflow automation platform with 2,300+ integrations. We’re looking to build a Weebly integration, but the public API documentation link appears to b…

---

## [Feature Request: API Access to Customer Notes and Files](https://developer.squareup.com/forums/t/feature-request-api-access-to-customer-notes-and-files/28091)

<div class="topic-metadata">

**Author:** [@oko](https://developer.squareup.com/forums/u/oko)\
**Replies:** 1\
**Last updated:** [October 6, 2026, 7:07pm UTC](https://developer.squareup.com/forums/t/feature-request-api-access-to-customer-notes-and-files/28091 "2026-10-06T19:07:08Z")

</div>

Square now supports Notes and files on customer profiles, including multiple timestamped notes, but these newer notes do not appear to be exposed through the Customers API. Add file attachments and notes to customer prof…

---

## [Read-only AI assistant connector: does it fit the Developer Terms, and does it work for HIPAA sellers and free-plan Bookings reads?](https://developer.squareup.com/forums/t/read-only-ai-assistant-connector-does-it-fit-the-developer-terms-and-does-it-work-for-hipaa-sellers-and-free-plan-bookings-reads/28057)

<div class="topic-metadata">

**Author:** [@safi\_cotter](https://developer.squareup.com/forums/u/safi_cotter)\
**Replies:** 1\
**Last updated:** [October 1, 2026, 9:23pm UTC](https://developer.squareup.com/forums/t/read-only-ai-assistant-connector-does-it-fit-the-developer-terms-and-does-it-work-for-hipaa-sellers-and-free-plan-bookings-reads/28057 "2026-10-01T21:23:25Z")

</div>

Hi, We’re Cotter Systems, and we run a hosted, read-only connector that lets business owners ask their own AI assistant (Claude or ChatGPT) questions about their business, answered from the systems they already use.. It…

---

## [Is the Card fingerprint consistent across sellers who authorise the same OAuth app?](https://developer.squareup.com/forums/t/is-the-card-fingerprint-consistent-across-sellers-who-authorise-the-same-oauth-app/28022)

<div class="topic-metadata">

**Author:** [@efacts\_founders](https://developer.squareup.com/forums/u/efacts_founders)\
**Replies:** 2\
**Last updated:** [September 29, 2026, 3:57pm UTC](https://developer.squareup.com/forums/t/is-the-card-fingerprint-consistent-across-sellers-who-authorise-the-same-oauth-app/28022 "2026-09-29T15:57:08Z")

</div>

Hi Square team, I’m building E-Facts (efacts.ca), a Canadian digital receipts app that sellers will connect through OAuth. We read Payments and Orders data to generate digital receipts for shoppers. I have a few questio…

---

## [Can square\_card\_id from a third-party card import mapping file be used as card\_id in CreateSubscription?](https://developer.squareup.com/forums/t/can-square-card-id-from-a-third-party-card-import-mapping-file-be-used-as-card-id-in-createsubscription/26811)

<div class="topic-metadata">

**Author:** [@jiyu](https://developer.squareup.com/forums/u/jiyu)\
**Replies:** 1\
**Last updated:** [July 24, 2026, 5:35pm UTC](https://developer.squareup.com/forums/t/can-square-card-id-from-a-third-party-card-import-mapping-file-be-used-as-card-id-in-createsubscription/26811 "2026-07-24T17:35:44Z")

</div>

Hi, We are planning to migrate existing subscribers from Stripe to Square. Square Support in Japan confirmed the following: Third-party card data can be imported from Stripe to Square. After the card import, the sell…

---

## [Customer ID from Reporting API Cube don't match with Square API and Manually Exported](https://developer.squareup.com/forums/t/customer-id-from-reporting-api-cube-dont-match-with-square-api-and-manually-exported/26556)

<div class="topic-metadata">

**Author:** [@Jamie11](https://developer.squareup.com/forums/u/Jamie11)\
**Replies:** 2\
**Last updated:** [June 29, 2026, 2:58pm UTC](https://developer.squareup.com/forums/t/customer-id-from-reporting-api-cube-dont-match-with-square-api-and-manually-exported/26556 "2026-06-29T14:58:57Z")

</div>

I was trying to use the Reporting API Cube, the one below is the customer\_id I got from Cube, but I can’t use it to match our customers (obtained from Customer API). I even use the api exploror to retrieve the customer …

---

## [Custom Attributes - URL type](https://developer.squareup.com/forums/t/custom-attributes-url-type/26052)

<div class="topic-metadata">

**Author:** [@oko](https://developer.squareup.com/forums/u/oko)\
**Replies:** 1\
**Last updated:** [May 12, 2026, 2:13pm UTC](https://developer.squareup.com/forums/t/custom-attributes-url-type/26052 "2026-05-12T14:13:15Z")

</div>

I would like to request additional type for custom attribute - URL. This would render as clickable url. We want to store clickable links to other system / CRM for quick reference of customer

---

## [Suppress customer notification flag to bookings API](https://developer.squareup.com/forums/t/suppress-customer-notification-flag-to-bookings-api/25709)

<div class="topic-metadata">

**Author:** [@dman](https://developer.squareup.com/forums/u/dman)\
**Replies:** 2\
**Last updated:** [May 5, 2026, 8:31pm UTC](https://developer.squareup.com/forums/t/suppress-customer-notification-flag-to-bookings-api/25709 "2026-05-05T20:31:22Z")

</div>

Description: We operate a hair salon with a custom booking system built on the Square Bookings API. We use the API to create, reschedule, and cancel appointments programmatically (via our iOS app and web admin dashboard)…

---

## [Does Checkout API Send Automatic Email Receipts?](https://developer.squareup.com/forums/t/does-checkout-api-send-automatic-email-receipts/25617)

<div class="topic-metadata">

**Author:** [@auwilliams](https://developer.squareup.com/forums/u/auwilliams)\
**Replies:** 4\
**Last updated:** [April 13, 2026, 9:01pm UTC](https://developer.squareup.com/forums/t/does-checkout-api-send-automatic-email-receipts/25617 "2026-04-13T21:01:01Z")

</div>

Hello, I’m a web developer that works with multiple Square clients. I’m encountering a situation where we’re using the Square Hosted Checkout API to make online sales, which is convenient, but I’m not receiving receipt e…

---

## [Clarification on OAuth limits for unlisted/private production applications](https://developer.squareup.com/forums/t/clarification-on-oauth-limits-for-unlisted-private-production-applications/25389)

<div class="topic-metadata">

**Author:** [@malikmady](https://developer.squareup.com/forums/u/malikmady)\
**Replies:** 1\
**Last updated:** [March 20, 2026, 8:54am UTC](https://developer.squareup.com/forums/t/clarification-on-oauth-limits-for-unlisted-private-production-applications/25389 "2026-03-20T08:54:06Z")

</div>

Hi Square Team, I am developing a web application that integrates with Square POS to sync product and location data. My application for the App Marketplace was recently declined due to capacity, so I am planning to move…

---

## [Create a dynamic payment amount for online checkout](https://developer.squareup.com/forums/t/create-a-dynamic-payment-amount-for-online-checkout/5708)

<div class="topic-metadata">

**Author:** [@drcarr](https://developer.squareup.com/forums/u/drcarr)\
**Replies:** 10\
**Last updated:** [January 21, 2026, 8:11pm UTC](https://developer.squareup.com/forums/t/create-a-dynamic-payment-amount-for-online-checkout/5708 "2026-01-21T20:11:35Z")

</div>

I have been using square payment form, which I understand is being deprecated. Currently, I allow my clients to enter their name and email address, along with an amount to contribute. That information is passed to the …

---

## [Calling Customer List Groups](https://developer.squareup.com/forums/t/calling-customer-list-groups/24997)

<div class="topic-metadata">

**Author:** [@khahn](https://developer.squareup.com/forums/u/khahn)\
**Replies:** 3\
**Last updated:** [January 6, 2026, 2:17pm UTC](https://developer.squareup.com/forums/t/calling-customer-list-groups/24997 "2026-01-06T14:17:50Z")

</div>

I have the below C# code calling the customer list groups endpoint the endpoint is always sending back a cursor unless I remove the limit and let it use the default. With the limit added to the query it never does come t…

---

## [Payload incorrect for customer.custom\_attribute.visible.updated webhook](https://developer.squareup.com/forums/t/payload-incorrect-for-customer-custom-attribute-visible-updated-webhook/24774)

<div class="topic-metadata">

**Author:** [@richard.aubin](https://developer.squareup.com/forums/u/richard.aubin)\
**Replies:** 2\
**Last updated:** [December 22, 2025, 6:58am UTC](https://developer.squareup.com/forums/t/payload-incorrect-for-customer-custom-attribute-visible-updated-webhook/24774 "2025-12-22T06:58:44Z")

</div>

The payload data object for webhook customer.custom\_attribute.visible.updated does not map correctly to the correspond .NET SDK type of CustomAttributeEventDataObject. The .NET Type has a property called CustomAttribute,…

---

## [Associate a customer to a payment made on a Square terminal](https://developer.squareup.com/forums/t/associate-a-customer-to-a-payment-made-on-a-square-terminal/24692)

<div class="topic-metadata">

**Author:** [@khahn](https://developer.squareup.com/forums/u/khahn)\
**Replies:** 4\
**Last updated:** [December 5, 2025, 7:37pm UTC](https://developer.squareup.com/forums/t/associate-a-customer-to-a-payment-made-on-a-square-terminal/24692 "2025-12-05T19:37:35Z")

</div>

Scenario definition: Store1 has a terminal device. Using the customer API one or more customers have been created for Store1. Customer-A, existing customer create via the API, makes a purchase and pays with a card at the…

---

## [Implement Multi-Phase Subscription (Setup + Recurring) with Payment Links?](https://developer.squareup.com/forums/t/implement-multi-phase-subscription-setup-recurring-with-payment-links/24581)

<div class="topic-metadata">

**Author:** [@maksudul](https://developer.squareup.com/forums/u/maksudul)\
**Replies:** 6\
**Last updated:** [November 24, 2025, 5:23pm UTC](https://developer.squareup.com/forums/t/implement-multi-phase-subscription-setup-recurring-with-payment-links/24581 "2025-11-24T17:23:55Z")

</div>

Hi everyone, I have been reading through this discussion regarding the confusion between Subscription Variations vs Subscription Phases and how to properly link them to a Checkout Payment Link. I understand the concept…

---

## [Customer Not Found Weirdness](https://developer.squareup.com/forums/t/customer-not-found-weirdness/24508)

<div class="topic-metadata">

**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\
**Replies:** 8\
**Last updated:** [November 15, 2025, 11:53pm UTC](https://developer.squareup.com/forums/t/customer-not-found-weirdness/24508 "2025-11-15T23:53:59Z")

</div>

In my database I use the customer API to create and save the squareid for every ‘customer’ associated with the business. Most are actual paying customers, some are potential customers I create based on email, etc. I use…

---

## [Clarification on Loyalty Sign-up Behavior with Same Email but Different Phone Numbers](https://developer.squareup.com/forums/t/clarification-on-loyalty-sign-up-behavior-with-same-email-but-different-phone-numbers/24327)

<div class="topic-metadata">

**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\
**Replies:** 3\
**Last updated:** [October 31, 2025, 2:22am UTC](https://developer.squareup.com/forums/t/clarification-on-loyalty-sign-up-behavior-with-same-email-but-different-phone-numbers/24327 "2025-10-31T02:22:48Z")

</div>

Dear Square Support Team, I hope you’re doing well. We’ve recently encountered an issue when customers attempt to register for Square Loyalty using the same email but a different phone number — the new phone number doe…

---

## [How to Check and Manage Text Message Marketing Subscriptions via API](https://developer.squareup.com/forums/t/how-to-check-and-manage-text-message-marketing-subscriptions-via-api/24065)

<div class="topic-metadata">

**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\
**Replies:** 6\
**Last updated:** [September 29, 2025, 4:18pm UTC](https://developer.squareup.com/forums/t/how-to-check-and-manage-text-message-marketing-subscriptions-via-api/24065 "2025-09-29T16:18:31Z")

</div>

Hi Square Team, I hope you’re doing well! I have a question regarding the Customer API. I understand that I can use the Square Customer API to check whether a customer is subscribed to email marketing. Is there als…

---

## [Cards point to old customer after merge](https://developer.squareup.com/forums/t/cards-point-to-old-customer-after-merge/22586)

<div class="topic-metadata">

**Author:** [@wjps](https://developer.squareup.com/forums/u/wjps)\
**Replies:** 6\
**Last updated:** [June 11, 2025, 7:31am UTC](https://developer.squareup.com/forums/t/cards-point-to-old-customer-after-merge/22586 "2025-06-11T07:31:58Z")

</div>

There seems to be some weirdness around the ways cards are handled in the API. After merging customers it seems like the customer\_id in the Card object is not updated and so points to a non-existent customer. However wh…

---

## [Inconsistent handling of updated\_at across modifiable entities and their API List/Search endpoints](https://developer.squareup.com/forums/t/inconsistent-handling-of-updated-at-across-modifiable-entities-and-their-api-list-search-endpoints/22394)

<div class="topic-metadata">

**Author:** [@jhardin\_accumula](https://developer.squareup.com/forums/u/jhardin_accumula)\
**Replies:** 1\
**Last updated:** [May 20, 2025, 5:06pm UTC](https://developer.squareup.com/forums/t/inconsistent-handling-of-updated-at-across-modifiable-entities-and-their-api-list-search-endpoints/22394 "2025-05-20T17:06:05Z")

</div>

Folks: We’re starting development of a data integration with Square, and my review of your various APIs reveals a (to me) pretty glaring omission: there is no consistent way to request data that has been modified since …

---

## [Linking Customer and COF to Multiple Sellers](https://developer.squareup.com/forums/t/linking-customer-and-cof-to-multiple-sellers/586)

<div class="topic-metadata">

**Author:** [@bryank](https://developer.squareup.com/forums/u/bryank)\
**Replies:** 18\
**Last updated:** [May 5, 2025, 4:48pm UTC](https://developer.squareup.com/forums/t/linking-customer-and-cof-to-multiple-sellers/586 "2025-05-05T16:48:41Z")

</div>

We’re doing an implementation where we will have our App processing payments on behalf of multiple different sellers. However, the app will have a single customer record with cards attached to that record which will need…

---

## ["merged" customer\_id confusion](https://developer.squareup.com/forums/t/merged-customer-id-confusion/22030)

<div class="topic-metadata">

**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\
**Replies:** 4\
**Last updated:** [April 24, 2025, 11:57am UTC](https://developer.squareup.com/forums/t/merged-customer-id-confusion/22030 "2025-04-24T11:57:44Z")

</div>

I have a yoga studio system. Students can buy individual class cards or subscriptions. I use the customer API get a square customer id for each new student. I save the returned ID in as primary key in my database ‘stude…

---

## [How to handle new customer in POS Square App?](https://developer.squareup.com/forums/t/how-to-handle-new-customer-in-pos-square-app/21957)

<div class="topic-metadata">

**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\
**Replies:** 3\
**Last updated:** [April 15, 2025, 6:20pm UTC](https://developer.squareup.com/forums/t/how-to-handle-new-customer-in-pos-square-app/21957 "2025-04-15T18:20:08Z")

</div>

I created a new square customer using the API. I tried to find that customer in the Square POS App, but no luck until I forced the app to quit, and restarted. Questions: Is there a way to get the App show the new cu…

---

## [Will Messages be added to API?](https://developer.squareup.com/forums/t/will-messages-be-added-to-api/18916)

<div class="topic-metadata">

**Author:** [@thehauntedbookshop](https://developer.squareup.com/forums/u/thehauntedbookshop)\
**Replies:** 5\
**Last updated:** [April 14, 2025, 5:54pm UTC](https://developer.squareup.com/forums/t/will-messages-be-added-to-api/18916 "2025-04-14T17:54:48Z")

</div>

We just signed up for a phone number and we’re using the in-app Messaging function, but sometimes we’d like to be able to send an automated update to the customer. For instance they special ordered a book and it has arri…

---

## [Customer segments in webhook](https://developer.squareup.com/forums/t/customer-segments-in-webhook/21712)

<div class="topic-metadata">

**Author:** [@dcl2](https://developer.squareup.com/forums/u/dcl2)\
**Replies:** 5\
**Last updated:** [April 7, 2025, 4:09pm UTC](https://developer.squareup.com/forums/t/customer-segments-in-webhook/21712 "2025-04-07T16:09:23Z")

</div>

The Customers webhooks currently send a list of group\_ids and, per the documentation here, (customer.created Webhook - Square API Reference) it should send a list of segment\_ids. However, I’m not seeing the segment\_ids f…

---

## [Doordash delivery through Square API](https://developer.squareup.com/forums/t/doordash-delivery-through-square-api/4538)

<div class="topic-metadata">

**Author:** [@vikramkhatri](https://developer.squareup.com/forums/u/vikramkhatri)\
**Replies:** 4\
**Last updated:** [March 16, 2025, 11:12pm UTC](https://developer.squareup.com/forums/t/doordash-delivery-through-square-api/4538 "2025-03-16T23:12:35Z")

</div>

Hi, Square Online allows order delivery through its partners such as Doordash. Can we integrate the same doordash delivery through our app that uses Square APIs to create orders and processes the payment? We are wonderi…

---

## [Error code: unexpected when saving card](https://developer.squareup.com/forums/t/error-code-unexpected-when-saving-card/21116)

<div class="topic-metadata">

**Author:** [@Dev777](https://developer.squareup.com/forums/u/Dev777)\
**Replies:** 6\
**Last updated:** [February 19, 2025, 11:22pm UTC](https://developer.squareup.com/forums/t/error-code-unexpected-when-saving-card/21116 "2025-02-19T23:22:42Z")

</div>

I’m using the latest flutter sdk 1.7.10 and have been able to successfully load the credit card entry form using await InAppPayments.startCardEntryFlow( // ✅ Dismiss the keyboard before opening Square’s UI collectPost…

---

## [Get payments by customer\_id](https://developer.squareup.com/forums/t/get-payments-by-customer-id/21036)

<div class="topic-metadata">

**Author:** [@shayne](https://developer.squareup.com/forums/u/shayne)\
**Replies:** 2\
**Last updated:** [February 12, 2025, 9:19pm UTC](https://developer.squareup.com/forums/t/get-payments-by-customer-id/21036 "2025-02-12T21:19:21Z")

</div>

Is it possible to query payments associated with a customer\_id?

---

## [Square is claiming valid phone numbers are invalid](https://developer.squareup.com/forums/t/square-is-claiming-valid-phone-numbers-are-invalid/20906)

<div class="topic-metadata">

**Author:** [@benzado](https://developer.squareup.com/forums/u/benzado)\
**Replies:** 6\
**Last updated:** [February 10, 2025, 8:40pm UTC](https://developer.squareup.com/forums/t/square-is-claiming-valid-phone-numbers-are-invalid/20906 "2025-02-10T20:40:23Z")

</div>

We’re using Square to handle payments for a business in London, where people from around the world come to take classes. A significant number of customers are unable to complete the checkout process because Square consi…

[Next page](https://developer.squareup.com/forums/tag/customers-api/2.md?match_all_tags=true&page=1&tags%5B%5D=customers-api)
